Fixing Bugs in the Common Dialogs 





Vol. 6,1 
anuary 


■ Borland 
spawn() 


PLUS: 


i OWL Command Enablers for Di; 
i Reducing MFC 
Resource Usage 


$4.50 US 

$5.95 Canada 


C++ 


■ Access the Common 
Dialogs from Fortran 

■ Hotkey Hooking across 
Windows and DOS 

■ Books in Brief: 

Six Vmial C++ Books 


I Micros >^H]++ of the Month: 

The Mi .mm Warning Message 
I Paul Botm^u Adds Semaphores 
to the VV^RTEE VxD 


SI Amts fiwwwi DM*n itew flWfMW 




ftrnihns nt<J •histri 

SHnWtai-slffBtfmj, 

a5,| *whRm, 


DEVELOPER'S JOURI 


ADVANCED. 


SERIOUS. TECHNICAL. 





























Experience the Ultimate in Visual 
Programming... ProtoGen+ 


ProtoGen+ has unlimited 
interactive visual pro¬ 
gramming power. 

Create full-blown applications with 
toolbars, scrollable forms, screen 
navigation, data validation, and 
help messages, using a scaleable 
architecture for adding database 
access, report writing, and other 
application building components. 
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Link Popup Window 
Link MDI Dialog 
Link MDI Child Window 
Link to Program 
Edit Code 

Link to Open File Dialog 
Link to Save File Dialog 
Link to Printer Setup 
Link to Color Select 



options for toolbars, menus, and 
other initial settings. Unlike 
AppWizard, which generates 
code that you have to compile to 
see run, ProtoGen+ displays the 
exact application options you 
have selected within its design 
window. Unlike the wizards, you 
can point and click to link 
screens to menus and toolbars. 

Enjoy new levels of 
ease and productivity 
with ProtoGen+'s pro¬ 
totyping capabilities. 

In addition, as you design your 
screens you can define data vali¬ 
dation, colors, fonts, help and 
error messages, which all display 
live in ProtoGen+’s test mode. 
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fThe ProtoGen+ workbench displays your application 
as you design it, giving you fast access to your applica¬ 
tion code and resources. 


What the experts are saying about ProtoGen+: 



^Visually link dialogs, code, programs, 
MDI Windows, and other components 
to menu items and toolbar buttons. 

Quickly go from user specification 
to product demonstration. 
Eliminate weeks and months from 
your development schedule. 

With ProtoGen+ you don’t have to 
wait for a compile to see your 
applications run. With a click of 
the mouse you’ll be live in test 
mode. Like AppWizard, you start 
your application by selecting 


ProtoGen+ comes with C, OWL 
MFC and Pascal generators. 

ProtoGen+ NT is the 
fastest way to create 
32-bit applications. 

ProtoGen+ NT has all the 32-bit 
power you need with hosted 
16/32-bit application develop¬ 
ment for the MIPS, DEC Alpha, 
and Intel processors. 

ProtoGen+ Only $199 
ProtoGen+ NT Only $495 



ProtoGen+ Client/Server Suite 


“ProtoGen+ successfully brings to Windows 
programmers 4GL ease of use and 3GL perfor¬ 
mance”. -Ron Carnahan, DBMS 

S’ “ProtoGen+ is a natural winner. Every 
developer who sees the ProtoView toots seems 
to relish the ease of both modifying and testing a 
user interface under construction. ” 

-Peter Coffee, PCWeek 

S ”ProtoGen+ will pay back your investment with 
much faster and easier prototyping and program 
development.” -Neil J. Rubenking, PC Magazine 

S “On a scale of 1 to 10, I’d rank ProtoView as a 
10 (the best).” 

-Richard Hale Shaw, Windows Tech 


The ProtoGen+ Client/Server Suite 
harnesses the power and speed of C 
and C++, the world's fastest lan¬ 
guages. The ProtoGen+ Client/Server 
Suite delivers an integrated compo¬ 
nent toolset in an open architecture 
that includes database access, forms 
building, report writing, application 
management and quality code gener¬ 
ation in C, MFC, OWL, and Pascal. 

Here's what's included in the 
ProtoGen+ Client/Server Suite. 

S ProtoGen+ - A visual development 
workbench that includes everything 
needed to visually develop screens, 
create menus, link screens and 
dialogs, test the app, and generate 
source code. 

S WinControl Library - A rich set of 
custom controls that let you obtain, 
format and edit data entered by 
users. 


^SQLView - Fast, easy visual data¬ 
base access through ODBC and 
Q+E database drivers. All the Q+E 
drivers are included FREE! SQLView 
also supplies a database-indepen¬ 
dent API for low-level control of data 
access and manipulation. Support is 
provided for all major PC and SQL 
databases. 

S DataTable and Lens Object - 

This control helps automate data¬ 
base browsing and updating. 

^Crystal Report Writer Pro with 
Report Writer Visual Coder - 

Visually create great looking reports. 
The Visual Coder acts as an integrat¬ 
ed component in ProtoGen+ generat¬ 
ing code for the report, creating links 
to the report, and executing the 
report in our live test mode. 
ProtoGen+ Client/Server Suite 
Only $995 
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fThe ProtoGen+ Client/Server Suite provides 
direct access to all major PC and SQL databases. 

Call to order now. 

1 - 800 - 231-8588 
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No matter what database they throw at you, you’ll 
connect with INTERSOLV ODBC Pack. 



Fastball, slider, or change-up. 
dBASE, Paradox, or Oracle. If you 
want to connect, you know 
you’ve got to react fast. 

With the comprehensive 
lineup of over 20 drivers in 
INTERSOLV ODBC Pack, you can. 

Cover all your bases with 
INTERSOLV. 

Drivers are the critical link 
between your ODBC-compliant 
applications, your network, and your 
databases. And because their quality 
directly affects the performance of 
your applications, it’s vital that you 
nave superior drivers. 

Don’t risk costly errors. Rely on 
INTERSOLV for fast, dependable 
drivers. 

INTERSOLV ODBC Pack 
delivers: 

• Comprehensive coverage: Connect 
ah ODBC-compliant applications to 
all major SQL and PC DBMS with 
INTERSOLV ODBC Pack. 

• Consistent access: INTERSOLV 
ODBC Pack drivers make all data¬ 
bases look the same so you don’t 
have to change the way you work 
every time you change databases. 

• State'of'the-art technology: 
INTERSOLV ODBC Pack gives you 
the same database access technology 
used by leading software publishers. 
Plus all drivers are certified through 
INTERSOLV’s ODBC Verification 
Suite. 

• High-level implementation: With 
INTERSOLV ODBC Pack you get 
full SQL, transaction processing, 
and even network locking support 
for non-SQL DBMS. Ana it’s the 


only set of drivers that 

S orts a consistent level of ODBC 
ore, Level 1, and selected Level 2 
functions. 

• One-stop, cross'platform support: 
No other set of ODBC drivers offers 
the range of support available from 
INTERSOLV. Support is available 
for Windows OS/2, Windows NT, 
and Solaris; support for Macintosh 
will be available in late 1994. 

Complete, dependable, and 
quick, INTERSOLV ODBC Pack 
makes sure your applications 
perform — no matter 
what database you 
have to face. 


INTERSOLV ODBC Pack provides support for the 
following databases: 

ALLBASE, Btrieve, Clipper, DB2, DB2/2, DB2/6000, dBASE, Excel, FoxBase, FoxPro, Gupta 
SQLBase, IMAGE/SQL, INFORMIX, INGRES, Microsoft SQL Server, Netware SQL, Oracle, 
Paradox, PROGRESS, SQL/400, SQL/OS, Sybase SQL Server, Sybase System 10, Teradata, 
Text, and XOB. 

INTERSOL V ODBC Pack is available for Windows OS/2, Windows NT, and Solaris and 
will support Macintosh in late 1994. Not all DBMS are available on all platforms and 
some may require a gateway. Please call for details 


Order INTERSOLV 
ODBC Pack today! 

Make sure your ODBC com¬ 
pliant applications work tomorrow. 
Put INTERSOLV ODBC Pack on 
your team today! Purchase directly 
from INTERSOLV. At only $499. 
it’s a steal! 

Get a free ODBC booklet! 

Be sure to request your FREE 
copy of Getting Connected — 

An ODBC Primer, whether 
you order INTERSOLV 
ODBC Pack or not. Call: 

1-800-876-3101 

ext. D019, 8 am to 8 pm EST. 


INTERSOLV 


©INTERSOLV, Inc, All rights reserved. INTERSOLV, Excelerator, Maintenance Workbench, PVCS, AND Q+E are registered trademarks 5540 Centerview Drive, Suite 324 • Raleigh, NC 27606 
and APS is a trademark of INTERSOLV, Inc. Other company or product names mentioned herein may be trademarks or registered 800-876-3101,(919) 859-2220, Fax (919) 859-9334 

trademarks of their respective companies. 
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OWL Command Enablers. 7 

Documented only in an addendum to Borland C++ v4.02, command enablers make it easy to manage and 
coordinate menu and toolbar events and states. This article shows that you can adapt them to dialog 
boxes as well, using them to control the states of buttons, for example. 

Robert Arnson 

Reducing MFC Multi-Document Resource Usage. 25 

The benefits of application frameworks sometimes have a cost. For example, using MFC to create a multi¬ 
document OLE server can exhaust the USER heap, due to the way MFC allocates resources. This article 
describes the problem and shows how to work around it. 

Walter J. Meerschaert 


Features 


Fixing Bugs in the Common Dialogs . 31 

The Common Dialogs are convenient, but not supported very well — Microsoft does not issue bug patches 
for them. Roger points out two nasty bugs in comndl g. dl 1 and shows how you can fix them on the fly from 
your application. Did you know that just clicking the mouse in the wrong place in the Choose Color dialog 
can produce a GP fault? 

Roger Alley 

Using Common Dialogs to Open Files from MS Fortran . ... 41 

The common dialogs give you a lot of user interface functionality in a small package. There’s no reason to 
miss out on these functions just because you're using Fortran. 

Kenneth G. Hamilton 

Capturing Hot Keys in Windows. 55 

Hot keys let the user access your application even while another application has the input focus. You can 
use WM_SETHOTKEY and WMJSETHOTKEY to implement hot keys, or you can use system wide hooks. Either way, 
your hot key won’t work when the user is in a DOS box. This article gives you the VxD you need to hook 
keys even from DOS boxes. 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 


Discover the secrets the insiders use 
with Windows Source! 

Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

❖ Includes Codeview symbols when 
available. 

❖ Identifies, by name, the VxD API 
entry points and services provided. 

❖ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $249.95! 

Call 800-648-8266 
to order now! 

V Communications, Inc. 

V) 4320 Stevens Creek Blvd., Suite 275-WD 

V- San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From the Editor 


We re looking for Visual Basic articles. We need short, reusable code (< 200 lines) 
that does handy things for Visual Basic programmers. Cot an idea on this subject? Send 
me email at 7l392.2566@cowpusene.com. ♦♦ I decided to stop being such a Luddite and try 
to leam to use precompiled headers; they're supposed to 'dramatically reduce compila¬ 
tion time.' After 15 minutes of manual-reading, head-scratching, and experimentation, I 
finally managed to get Borland C++ v4.02 to create and then use a precompiled header. 
The result was that the precompiled headers transformed my 19-second compile into an 
18-second compile. Is it just me, or are precompiled headers a joke? ♦♦ About a year 
ago, I paid Microsoft $900 for the privilege of getting the Chicago beta, and I asked for 
permission to run technical articles about it. No dice. Microsoft has finally given us (all 
beta testers actually, not W/DDJ in particular) permission to write about Chicago. I don't 
quite see how suppressing independent technical information has helped Microsoft sell 
their O/S to developers, but that's certainly their prerogative. Funny thing is, few readers 
have been asking for Chicago articles. Oh well, at least you can legally send us article 
proposals now. ♦♦ Visual C++ v2.0 apparently just shipped as I'm writing this. Sounds 
like it includes Visual C++ vl.51, some kind of update to the 16-bit compiler. I could 
never figure out from the unique brand of English used in Microsoft press releases 
whether or not I can run Visual C++ v2.0 under Windows 3.1. If you're tinkering with 
OLE, the new 16-bit OLE Automation headers have been reported missing in this pack¬ 
age - you can download them from CompuServe forum WINOBJEC. ♦♦ By the time this 
appears. I'm sure you will have heard most Pentiums have a numeric hardware bug. 
The victims will be floating-point intensive applications; the bug is that FDIV produces less 
than perfect results for a variety of denominators when the numerator is a power of two. 
More interesting than the hardware problem is the PR problem, though - Intel must 
project the impression that they stand behind their product, while absolutely avoiding 
any commitment to replace millions of buggy chips already in the field. Is the bug going 
to break lots of applications? Not at all. On the other hand, when you plop down $3,500 
for your new P-90 system, wouldn't you prefer to get the version of the chip that does 
not have the little bug? ♦♦ Lots of column news: In honor of our C++ theme, Mark 
Nelson has supplied a double-header of the Bug++ of the Month. Tech Tips is on hiatus 
and returns next month. I was close to delivering this month's Practical C++ column, 
when I was suddenly struck with a vision of a Much Better Design. I'm now furiously 
rewriting WUIMAN from the ground up; it will reappear when It's functional. ♦♦ I've 
said it many times, but I still run into people who don't know they can use email to 
subscribe, renew, or replace a missing or damaged issue. All these things are as easy as 
sending email to wdsub@rdpub.com. From CompuServe, that would be >IH- 
TERNET:wdsub@rdpub.com. You can even buy a t-shirt that wayl ♦♦ Is anyone really buying 
these books that claim to reveal Microsoft's secrets for writing good code? For example, 
Steve Maguire has a book subtitled 'Microsoft's Techniques for Developing Bug-Free C 
Programs'. I'm still trying to find a single bug-free Microsoft program, but no luck so far (I 
will say that clock.exe has not crashed my system yet, but I think they bought that one 
from a third party). Whether it's UAEs when moving a frame In WinWord v6 or being 
dropped to DOS by the registry editor, Microsoft software craftsmanship makes life a 
carnival of surprises. 


Ron Burk 

Editor 

CIS: 79392,2566, Internet: ronb@rdpub.com (“...iuunetlrdpubironb") 
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Lets You Build Real, Heavy-Duty Programs Without Writing a Single Line of Code. Free 


PC Week called Layout a “sure thing.” 
We call it a revolution. With over 200,000 
users and tons of add-ons and third-party 
support, Layout is the only tool that lets 
you build DOS or Windows programs by 
manipulating objects on 
screen — without writing 
code. Not just simple pro¬ 
grams, but heavy-duty, mis¬ 
sion-critical applications. 

The True Power of Objects 

Layout is truly object-ori¬ 
ented, both in the programs 
it creates, and in how you use 
it. You start out by arranging 
objects in a simple diagram, 
and then you add more ob¬ 
jects as your program grows, 
or create new objects by com¬ 
bining existing ones. You can 
run your program as you're 
building it, and tinker with 
any aspect of it. Data-entry, 
database, and report formats 
are all visually designed, right on-screen. 



Windows, with NT and OS/2 coming 
soon, and applications written on any of 
these platforms are automatically por¬ 
table to the others — including Windows 
95 (Chicago). 


I ayout (or Windows ADDRE SS.FL0 


doesn’t just spit out pre-canned code like 
other so-called high-level tools. And now, 
Objects, Inc. is offering a free Windows 
95 Toolkit with every Layout for Win¬ 
dows so you can start building Windows 
95 programs today! 


Elle Edit Objects Flowchart Jools Options Help 
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Use A Procedure 

Setup Address Book 


Open a CardFile 

address book cardfile 


Open A Window 

Address Book Window 


Repeat Until... 

selected button = Finished on Control Panel 


Clear Card Contents 

Remove old information from screen 


El 

Retrieve a Card 

get current card 

BBEIt 

Display Card 

Address 


Layout is the Ultimate Tool 

Layout delivers the fu¬ 
ture for $299.95, in¬ 
cluding everything 
you need to build pro¬ 
grams; free, unlim¬ 
ited, technical sup¬ 
port; and superb 
documentation. Call 
today, join the Lay¬ 
out revolution, and 
never see code again. 
Ever. 


When you’re done, Layout creates real 
.EXE files, or well-structured and efficient 
C/C++, Pascal, or BASIC programs. And 
because Layout has a completely open 
architecture, you can create new objects 
right in Layout, or even re-use existing 
source code. Layout supports DOS and 


Visual Power, Incredible Performance 

The programs Layout creates are com¬ 
pletely graphical, even under DOS, and 
fully support OLE 2.0, DDE, 3D but¬ 
tons, hypertext links, messaging, creating 
and using DLLs, and much more. Layout 
even supports pictures as a data-type! 
Layout creates very efficient programs — 
they’re fast and compact. No 150K “Hello 
World” programs come out of Layout: it 
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C++ 


OWL Command Enablers 


Robert Arnson 


OWL 2.x includes several features that let you write applications differently 
than you would in C. One of those features is the largely undocumented com¬ 
mand enabler. Rather than explicitly enabling and disabling menu items and 
tool bar buttons whenever their state changes, you can do it in a central func¬ 
tion that OWL calls. For example, the Edit|Copy and Edit|Cut menu items should 
be enabled only when there's selected text or a selected object. In C, you'd 
probably call EnableMenuItemO in your selection and deselection functions, to 
directly enable or disable the appropriate menu items. With OWL, you'd write a 
command enabler, in addition to a command handler function, and tie it in 
with the EV_COMMAND_ENABLE event response table entry macro, as shown in Fig¬ 
ure 1. OWL would then call your command enabler at runtime and give it an 
opportunity to enable or disable the menu item. 

Once you're accustomed to using command enablers (and it does take time 
to change mindsets), you miss them when they're not available. I missed them 
in dialog boxes. I wanted to make sure the OK button was only enabled after 
the user had selected an item. Because there were a couple of ways to do that, 
I had to resort to using EnableUindowO in ail the places where the user selected 
items. I knew how much nicer a command enabler would've been, so I decided 
to see how difficult it would be to write one that would let you enable and 
disable buttons on a dialog box. It took a bit of digging, as even the use of 
command enablers was undocumented until the OWL documentation adden¬ 
dum for Borland C++ 4.02 came out, to say nothing of their implementation. 
But the results were well worth it. 


Bob Arnson, who used to work in Borland's Technical Publications department 
on C++ projects, is now a freelance writer, editor, and consultant. He's the 
coauthor of ObjectWindows 2.0 Programming, published by Random House. 
He's also a member of Team Borland, Borland's group of volunteers who help 
support Borland products on CompuServe, GEnie, and BIX. 
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How Do They Work? 

To create a new kind of command enabler, you must 
begin by understanding how the existing ones work. OWL 
2.x has three command enabler classes: TCommandEnabler, 
which is an abstract class, and TMenuItemEnabler and TBut- 
tonGadgetEnabler, both of which are derived from TComaan- 


dEnabler. As you can tell from the names, TMenuItemEnabler 
is used for menu items (in a popup menu) and TButton- 
GadgetEnabler is used for button gadgets on a tool bar. Be¬ 
cause it's abstract, TCommandEnabler is never itself instanti¬ 
ated, but your command enablers get a TCommandEnabler 


Figure 1 An OWL command enabler for menu items 


DEFINE_RESP0NSE_TABLE1(TCorralDrawWnd. TWindow) 
EV_COMMAND(CM.EDITCOPY, CmEditCopy), 

EV_COMMAND_ENABLE(CM_EDITCOPY. CeEditCopyAndCut), 
EV_COMMAND(CM_EDITCUT, CmEditCut), 
EV_COMMAND_ENABLE(CM_EDITCUT, CeEditCopyAndCut), 
END_RESPONSE_TABLE: 

void 

TCorralDrawWnd::CmEditCopy() 

{ 

// copy selected object(s) to the Clipboard 

} 

void 

TCorral DrawWnd: iCmEditCutO 
{ 

// cut selected object(s) to the Clipboard 

} 

void 

TCorralDrawWnd::CeEditCopyAndCutCTCommandEnabler& ce) 
{ 

ce.Enable(AreAnyObjectsSelectedO); 

} 


Listing 1 dialog.cpp — A modal dialog class that 

supports idle events and command enabling 


// Implements class BDialog, a TDialog descendant that 
// o supports modality via TApplication::BeginModal 
// o supports command enabling of controls 

#define _0WLPCH 
//include <owl/owlpch.h> 

//include <owl/button.h> 

//include "dialog.h" 

DEFINE_RESP0NSE_TABLE1(BDialog. TDialog) 

END_RESPONSE_TABLE; 

BDialog::BDia 1ogCTWindow* parent, TResId resld, 

TModule* module) 

: TDialogCparent, resld, module) 

{ 

Modality = FALSE; 

} 

//--Execute, Destroy, and CloseWindow. 

// Support BeginModal-style pseudomodal dialogs 
int BDialog::Execute(int flags) 

{ 

// only do BeginModal if an MB_ flag is specified 



Translate 
your old 
PASCAL or 
BASIC code 
into readable 
and maintainable 
C at up to 3000 
lines per minute. 


Vax Pascal C 

Turbo Pascal C 

Microsoft Pascal C 
Microsoft GW-Basic C 

Microsoft Quick Basic C 

Microsoft Professional Basic C 
Turbo Pascal with Objects C++ 


Technosoft (Europe) 
Enterprise House 
Cherry Orchard Lane 
Salisbury SP2 7LD, UK 
’Phone: +44-722-414201 
Fax: +44-794-884087 


Technosoft (US) 

PO Box 8210 
Rockford IL 61126-8210 
’Phone: 815-397-3214 
Fax: 815-397-0619 
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Fastest, Most Powerful Text 
Retrieval Technology Available 

Based on ZylNDEX—leader from the beginning 
in PC text retrieval 



• Search 1 GB in Less Than 5 Seconds 

• Up to 50 Million Documents, 10 GB Total Per Index 

• Powerful Searches: Word, Phrase, Proximity, Boolean, 

Wild Cards and More 

• Works Directly with MS Word, WordPerfect, AmiPro, 

dBASE, ASCII, and Others 

Ideal for use with high-level application development 
environments such as Visual Basic, ToolBook, 
KnowledgePro, and ObjectVision. 


Windows, DOS, and NT 
libraries available $3,995 

Call for Specs 7 130 W. Lake Cook Rd. • Buffalo Grove, IL 60089 
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YOU ALREADY USE OUR 
PRODUCTS EVERY DAY 



SIINJCE 1379 THE WORLD’S l_E/\DII\IG COIVIPAIMIES HAVE 
BUILT THEIR APPLICATIONS WITH OUR TECHNOLOGY 

THE PROFESSIONAL DBMS 

FOR VOUR NEXT PROJECT CONSIDER FAIRCOIVI: 
THE BEST PRICE FOR THE BEST PERFORMANCE 


c-tree Plus® 



FAIRCOM Server® r-tree® d-tree™ 


HIGH PERFORMANCE DBMS 

By simply linking with a different o-tree 
Plus library, an application can move from 
a single-user application to a multi-user 
application, to a client/server application, 
c-tree Plus is distributed in complete C 
source code and is known for its 
unparalleled flexibility, portability and 
royalty free licensing policy. This licensing 
puts your development budget to work for 
you. c-tree Plus provides "makes" for the 
following platforms: DOS (Microsoft C, 
Borland C, Symantec, and for Zortech C 
and Watcom C, 16/32-bit); Microsoft 
Windows (Microsoft C, Borland C); 
Microsoft NT; OS/2 (Microsoft C, IBM 
C/SET, Borland OS/2); Unix; QNX (16 
and 32-bit); Coherent; IBM RS6000; 
SUN; Motorola 880PEN; HP9000; Xenix; 
Apple Macintosh and DEC Alpha. 

- COMPLETE "C" SOURCE CODE 

- SINGLE/MULTI USER 

- CLIENT/SEVER (optional) 

- FULL ISAM FUNCTIONALITY 

- NO ROYALTIES 
-TRANSACTION PROCESSING 

- FIXED/VARIABLE LENGTH RECORDS 

- MULTIPLE KEYS 

- DYNAMIC SPACE RECLAMATION 

- HIGH SPEED DATA/INDEX CACHING 

- BATCH OPERATIONS 

- UNSURPASSED PORTABILITY 


SERVERS SQL & non-SQL 

These servers utilize true client/server 
logic, and are available for the following 
platforms: DOS/Windows, Windows NT, 
NLM, OS/2, AT&T Unix, SCO Unix, 
Interactive Unix, QNX, Banyan, HP9000, 
SUN, Solaris, IBM RS6000, Motorola 88 
OPEN, Apple A/UX, Apple System 7, 
DEC Alpha. 

FairCom Servers communicate using 
NETBIOS, SPX/IPX, TCP/IP, shared 
memory, message queues or StreetTalk 
depending on the server platform. Most 
server platforms support more than one 
protocol, providing you the flexibility to 
choose how your client applications 
communicate to the server. For example, 
the FairCom OS/2 server can communi¬ 
cate with shared memory and NETBIOS 
clients at the same time. 

- CLIENT/SERVER MODEL 
-TRANSACTION PROCESSING 

- USER-CONTROLLED CACHING 

- REQUIRES < 2MB RAM 
-ON-LINE BACKUP 

- DISASTER RECOVERY 

- ROLL BACK - FORWARD 

- ANTI-DEADLOCK RESOLUTION 
-CLIENT-SIDE "C“ SOURCE 

- MULTI-THREADED 

- HETEROGENEOUS NETWORK 

- OEM (UPON REQUEST) 


REPORT GENERATOR 

The r-tree Report Generator handles 
virtually every aspect of report genera¬ 
tion. 

- COMPLETE "C" SOURCE CODE 

- COMPLEX MULTI-LINE REPORTS 
-MULTI-FILE ACCESS 

- COMPLETE LAYOUT CONTROL 

- CONDITIONAL PAGE BREAKS 

- NESTED HEADERS AND FOOTERS 

- DYNAMIC FORMAT SPECIFICATIONS 

- HORIZONTAL REPEATS 

- AUTOMATIC ACCUMULATORS 


FAIRCOM Server® 



HETEROGENEOUS 
TCP/IP NETWORK 


APPLICATION DEVELOPMENT 

The d-tree development toolbox 
increases application development 
productivity without relinquishing 
control. It provides the convenience 
of a 4GL product at the C develop¬ 
ment tool level, d-tree offers the 
beginning programmer a bridge to 
the control, flexibility, and portability 
obtained only at the C development 
level. The experienced C program¬ 
mer benefits from increased results 
while maintaining low-level flexibility, 
d-tree saves you valuable develop¬ 
ment time and is like no other 
development tool available today. 
With d-tree's unique design concept, 
you have the best of 4GL and C 
together. 

- COMPLETE "C" SOURCE CODE 

- PROTOTYPE GENERATION 

- DATA DICTIONARY 

- PORTABLE SCREEN HANDLER 

- RUNTIME RESOURCE CONTROL 

- FLEXIBLE DATA WINDOWS 

- DATA FILE REFORMATTING 

- EASY TO USE DBMS INTERFACE 

- FIELD MASK VALIDATION 

- INTERACTIVE HELP DESIGN 

- SUB-FILE ROUTINES 

- MENU MANAGEMENT 

- DATA IMPORT/EXPORT 

- MUCH MUCH MORE 


THE UNIQUE SOLUTION: ONE PRODUCT FOR OVER 100 PLATFORMS 
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ire you wasting valuable 
development time? Money? 
System resources? Do you 
have too much information 
to be presented within one 
dialog box or form? Then put 
TAB/PRO to work for you today. 
Part of the FarPoint suite of com¬ 
ponent solutions, TAB/PRO is a 
container control that will save you 
time and money and help you to con¬ 
serve those system resources. It brings 
three familiar desktop metaphors to life 
within your projects: Index Cards, File 
Folders and Notebooks. Each one offers 
you a feature-rich set of properties and 
events. You can insert, delete and move 
tabs, drag ’n drop controls within tabs, set 
multiple pages with ear marks for each tab 
and set up notebooks with spiral or ring 
tinders. And of course it’s royalty free. Call 
today for more information and a free demo disk. 

Mention this ad with your order 
and you’ll receive $20 off the SRP of $99. 


133 Southcenter Court 
Suite 1000 

Morrisville, North Carolina 27560 
Phone (800) 645-5913 
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Listing 1 continued 


if (!flags) 

return TDialog::Execute(); 

// create and show (if necessary) the dialog--remember that 
// Create always returns true (or throws an exception) 
Created; 

if (STWindow::Attr.Style & WSJISIBLE) 

Show(SW_SHOW); 

// begin modality! 

Modality = TRUE; 


TWindow* modalWindow = flags i (MB_SYSTEMMODAL 

I MBJASKMODAL) ? this : Parent; 
return GetApplication()->BeginModal(modalWindow, flags): 

} 

void BDialog::Destroy(int retValue) 

{ 

if (Modality) 

GetApplication{)->EndModal(retValue); 

TDialog::Destroy(retValue); 

} 


argument so that OWL can send 
either TMenuItemEnabler or TButton- 
GadgetEnabler instances, as needed. 

The virtual TCowmandEnabler mem¬ 
ber functions you can use for both 
menu items and tool bar buttons are: 
EnableO, SetTextO, and SetCheckO. 

EnableO takes a Boolean argu¬ 
ment that specifies whether the 
menu item or button gadget should 
be enabled. SetTextO is only useful 
for menu items; it lets you change 
the text of the menu item. (For exam¬ 
ple, you might want to toggle be¬ 
tween "Show tool bar" and 'Hide tool 
bar" rather than using a check mark.) 
SetCheckO lets you place or remove a 
check mark from the side of the 
menu item; for tool bar buttons, it 
lets you 'press' an exclusive button. 
In other words, you can do more 
with command enablers than just en¬ 
able and disable things. 

It's important to remember that 
command enablers work off com¬ 
mand IDs, not specific menu items or 
tool bar buttons. In fact, that's why 
you can use a single command en¬ 
abler for both menu items and tool 
bar buttons - they both have the 
same command ID. However, when 
and how OWL invokes a command 
enabler depends on whether the cor¬ 
responding ID is used in a menu item 
or tool bar button. 

Here's roughly how it works for a 
menu item. 

When the user opens a popup 
menu (by clicking on its title in the 
menu bar, or by pressing the Alt+Iet- 
ter shortcut key), Windows sends the 
menu's frame window a UM_INITMENU- 
POPUP message. OWL responds to this 
message in TFrameWindow: :EvInitMenu- 
PopupO by going through each item 


SERIAL I/O 


The ONLY Serial Communication Libraries, DLLs, & Tools You Will Ever 
Need For Windows & MS-DOS. Accept No Less Than The Best!! 



Supported By All Products 

• Unlimited number of ports active concurrently. 

• Hardware/Software Flow Control. 

• 8250/16450/16550 Auto detection/Up to 115200 baud. 

• Remap baud rates/Change baud rate divisor. 

• 100% Port re-entrant code(Important for multitasking) 

• Support for several intelligent & all dumb multiport cards 
(Amet, Digiboard, Boca, GTEK, AST, & more). 

• Product Customization. 


COMM-DRV/LIB™ 

Professional Serial I/O Libraries & DLLs 
for WINDOWS & MSDOS 

• Supports ALL languages, tools, or applica¬ 
tions that can call the Windows API. 

• Complete source code to all libraries. On 
line help. 

• Same API for Windows or MSDOS. 

• High level Hayes compatible modem sup¬ 
port. 

• X, Y, & Zmodem on multiple ports concur¬ 
rently. 

• ANSI/BIOS screen management utility. 

• Asynchronous & timed callback to user functions on 
different serial communication events(modem signals, 
buffer count, character reception, and much more). 

• Supports Quickbasic, Visual Basic(DOS&Windows), ANSI 
C/C++, Visual C/C++, Assembly. 

• Transmit data from user callback on any event(Important 
for multidrop applications). 

• Extensive scanning of input character stream. 


COMM-DRV/LIB.S189.95 

COMM-DRV/DOS.$99.95 

COMM-DRV/WIN.$99.95 

COMM-DRV/V xD(Introductory Offer).$99.95 

4PortMultiportCard(16450).$110.00 

4 Port Multiport Card(16550A).$170.00 

8 Port Multiport Card(16550A).$225.00 

SoftwareCombo(Lib,VxD,Dos,Win).$399.95 

CompleteCombo(Sftwe+4Portw/16550).$499.95 


COMM-DRV/DOS™ 

MS-DOS Serial I/O TSRs & Utilities 

• True DOS device driver that allows serial ports to be 
opened as normal files under MS-DOS or Windows. 

• TSR to redirect serial data to keyboard buffer, transpar¬ 
ent to user application(Great for barcode & POS apps). 

• Provides FOSSIL interface for all supported cards(BBS 
operators). 

• Provides INT14H , INT21H, & DAM interfaces. 

• Compatible with Desqview and Win¬ 
dows. 

• Real time serial port monitoring to 
screen and disk. 

• Mini-BBS for file transfer/Spawnable 
stand-alone file transfer engine. 

COMM-DRV/WIN™ 

Windows Replacement Serial 
Communications Driver 

• True Windows comm device replace¬ 
ment. Use your favorite Windows com¬ 
munication applications on all multi- 

port cards we support. 

• Allow the use of more than 9 serial ports under 
Windows by allowing users to remap any serial port on 
the fly. 

COMM-DRV/V xD™ 

High Performance Serial I/O VxD For Windows 

• Windows DLLs with API calls into the 32 bit VxD. 

• MSDOS libraries for calling VxD from a DOS box. 

• Handles all serial communication interrupts at ring zero 
and in 32 bit mode. 

• Automatic detection of 16550 UARTs and uses both 
the transmit and receive FIFOs. 

• May be called from Windows & MS-DOS concurrently. 

• Baud rates up to 115.2K baud under Windows!!! 

• Integrates seamlessly with all COMM-DRV products. 
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in the popup, searching for a command enabler for each 
item's ID. If it doesn't find one, it then searches for a com¬ 
mand handler (EV_COMMANDi; if it doesn't find one of those, it 
disables the menu item (this explains why all your menu 
items are disabled until you add command handlers). If it 
does find a command handler, it calls the handler, passing 
it a temporary instance of TMenuItenEnabler. 


Also, as part of standard command routing, OWL looks 
for command handlers and enablers in the parent win¬ 
dow, grandparent window, and so on. If it can't find them 
in any parent window, OWL then looks in the application 
object. 


Listing 1 continued 


void BDialog::CloseWindow(int retValue) 

void EnableCBOOL enable); 

void SetText(const char far* str); 

{ 

void SetChecktint check); 

if (Modality) { 


if (CanCloseO) { 

protected: 

Trans ferData ( tdGetData ) ; 

TButton* Button; 

Destroy!retValue): 

} 

} else 

}; 

void BButtonEnabler::Enable(B00L enable) 

TDialog::CloseWindow(retValue): 

{ 

I 

TCommandEnabler::Enable(enable) ; 

//- -BButtonEnabler. 

Button->EnableWindow(enable ) ; 

} 

// Add command enabling for buttons (push buttons, check 


// boxes, and radio buttons)--not just menus and gadgets 

void BButtonEnabler::SetTexttconst char far* str) 

class BButtonEnabler : public TCommandEnabler 

{ 

{ 

// to prevent flicker, only change the button caption 

public: 

// if it’s different from the current caption 

BButtonEnabler(TButton* button, HWND hWndReceiver) 

int length = Button->GetWindowTextLength( ) + 1; 

: TCommandEnabler(button->Attr.Id, hWndReceiver) 

char* text = new char[1ength]; 

{ Button = button; } 

Button->GetWindowTextftext, 1ength); 


if (strcmp(str, text)) 


Hands-On Windows Developer Training 


Take Your Pick: MFC or OWL! 


C++ and Windows 
in a Week 

We teach experienced C programmers 

the basics of C++ in two days, then add 
three days of Windows programming using 
a C++ class library. In C++, you leam the 
complete syntax (including templates and 
exceptions), and how to begin “thinking in 
objects.” The Windows course shows you 
how to design and build a modem Frame- 
Document-View Windows application. 
There are two versions: Visual C++ 1.5 
with the Microsoft Foundation Classes 
and Borland’s Object-Windows 2.0. 

Each course has plenty of hands-on 
experience with the developer tools and 
visual assistants provided by the software 
publisher. 


C++ as a “Second Language” 

For programmers who have worked in 
languages other than C. The complete 
C++ language, with object-oriented 
analysis and design concepts. Four days. 
Graduates can enter our Windows course 
on Day 3. Generic C++, not specific to 
Windows and DOS. 

Also Available: 

Intro to Visual Basic Four days. 
Advanced Visual Basic Three days. 

Experience Counts! 

&msg has taught C++ and Windows since 
1989. We have been selected as a 
Borland Connections Training Partner. 
All courses available for onsite 
presentation, including customization. 


UPCOMING PUBLIC COURSES: 

Washington, DC Area 
C++/Win in a Week 

Microsoft Visual C++ 1.5: 
Jan. 23 - 27 

Borland’s 

Object Windows 2.0: 
Jan. 9-13 


&msg 

Messaging Systems Group, Inc. 
1559 Rockville Pike, Suite 250 
Rockville, MD 20852 


1 - 800 - 388-3535 

In MD call (301) 230-1840 




Call Today to Register. 
Learn Object Technology 
and Windows NOW! 
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THERE IS A SAFE, DIRECT ROUTE TO CLIENT/SERVER. 


Now you can move to client/ 
server without giving up the 
control professional program¬ 
mers demand. The secret is 
Btrieve 6 Database Manager 
and it makes the change to 
client/server far less uncertain. 

INTRODUCING NAVIGATIONAL 
CLIENT/SERVER. 

Predetermined SQL optimiza¬ 
tion routines can limit your 
control and performance. With 
navigational client/server, you 
can chart the fastest path to 
your data by designing relational 
structures and following them 
with precise directional controls 
to retrieve, insert, delete and 
update distributed data. 

As the first navigational client/ 
server database, Btrieve 6 


NAVIGATE YOUR WAY WITH BTRIEVE 6. 


provides the infrastructure to 
build multigigabyte database 
servers that can support 
hundreds of users with sub¬ 
second response times. Using 
your existing 3, 4 and 5GL 
tools, create or replace your 
data management code with 
Btrieve 6. Couple it with the 
application code and you're 
there. Btrieve 6 supports the 
major server platforms, NetWare 
Windows NT and OS/2 and 
the major client platforms. 

Btrieve 6 directional con¬ 
trols integrate with existing 
application code so you can ’ 
easily upgrade non-SQL appli¬ 
cations to client/server This way, 
your end-users wont need the 
kind of massive retraining that 
accompanies a change to SQL 


applications, an effort that can 
take from 40 to 50% of the 
typical conversion budget. 
(Source: The Gartner Group) 

THE PAINLESS WAY TO SQL. 

For SQL access, simply integrate 
Btrieve 6 with Scalable SQL, 
our award-winning relational 
database. Both are built on our 



new Microkernel Database 
Engine™ which allows both 
navigational and SQL applica¬ 
tions concurrent access to data. 

NAVIGATE SAFELY WITH 
BTRIEVE 6. 

Stories of time and money lost 
changing to client/server could 
fill volumes. With Btrieve 6, 
you can avoid the pitfalls. You’ll 
have the control and conven¬ 
ience of using your own tools 
and writing in your own 
language. And you can add 
SQL technologies as required. 

I So navigate the safer route to 
I client/server with Btrieve 6. 

IT SIMPLY WORKS 

"8 BTRIEVE 

: fi/HI TECHNOLOGIES 

To receive a free white paper call 

800-BTRIEVE or (512) 794-1719. 


O Request Reader Service #169 □ 
























GUIs are Easy with GUI-Kit 



1. Your Boss calls on 
Monday and politely 
tells you to port the 
OS/2 Payroll application 
to Windows by Friday. 


2. You tell him: "No 
problem, we wrote it 
using GUI-Kit. We can 
easily finish by Friday." 


3. You quickly and 
painlessly port the 
application from OS/2 to 
Windows. That was just as 
easy as writing it the first 
time! 


4. You're done by 
Monday afternoon - now 
you can just sit-back 
and relax until Friday! 


Simplify Your Life! Are you tired of dealing with 
tedious GUI programming details when you wish you 
could concentrate on writing your application? GUI- 
Kit is a C and C++ GUI toolkit that simplifies your 
GUI development. We have designed GUI-Kit 
around the way you think and work. Thanks to its 
intuitive and elegant object-oriented 
programming model, it is easy to turn your 


ideas into a GUI-Kit application. GUI-Kit is 
also easy to learn. You can be writing 
your first application within a couple of 
hours. No longer will you have to search API 
manuals for the correct function call or 
message structure. 

Make Your Application Portable The way 

GUIs are shaking out, you can never be sure where 
you'll need to run your application. Even Microsoft's 
Windows APIs are incompatible with each other. 



Instead of locking yourself into a GUI-specific toolkit, 
use GUI-Kit. GUI-Kit provides portability between 
Windows 3.1 (Win32s), Windows NT, Windows 95, 
OS/2, and UNIX/Motif and it works with C and C++. 

If you are currently using C and you are planning on 
migrating to C++ later, no problem. You 
a can reuse your GUI-Kit C code in C++. 


Shrink Your Application Typical 
GUI-Kit applications are 75% smaller than 
their API counterparts. This means that you 
can develop applications faster and they'll be 
easier to understand and maintain. They will also 
be more reliable. 

Order Today! You can't beat our price, and with 
our 60-day unconditional money-back guarantee, 
you can try it absolutely risk free. 


Order GUI-Kit Today! 

800 - 247-2108 


★ Extremely short learning curve 

★ No runtime fees! 

★ Free Support by our highly-qualified staff 
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★ Includes DMAKE, a cross-platform MAKE 
utility. Write your makefiles once and use them 
everywhere! 

★ Includes over 3300 portable icons! 

★ Works with C or C++ 

★ Straight-forward and intuitive programming 


★ Complete documentation - over 500 pages 

★ Extensible - lets you create new classes 

★ Built-in support for sprite animation 

★ Easy-to-use and flexible layout manager 

★ Supports Microsoft C/C++ 8.0 (32-bit), Visual 
C++ 32-bit, Borland C++ 4.0, more on the way! 

★ Portable Resources - No recompilation 
needed after a resource change 

★ Lets your users customize fonts, colors, etc. 

★ Rapid application development with gkproto - 
our visual prototyping tool 
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THenuItemEnabler contains the code to actually manipu¬ 
late the menu item (gray it, add/remove the check mark, 
and change the text) when you call its member functions. 

The mechanics for enabling tool bar buttons are quite 
different from those for menu items, as the tool bar is 
always visible (unlike the items in a popup menu). Obvi¬ 
ously, OWL needs to call tool bar button enablers fre¬ 
quently, so the tool bar graphically reflects what the en¬ 


ablers have done. To keep performance reasonable, 
OWL only does tool bar enabling during idle time, 
which is the time after an application finishes process¬ 
ing all of its pending messages and before it receives 
the next message. 

At idle time, OWL, which is in charge of your applica¬ 
tion's message loop, calls the application object's IdleAc- 
tlonO member function, which calls the main window 


Listing 1 continued 


Button->SetW1ndowText(str): 

// if It exists 

delete [] text: 

BButtonEnabler enablertbutton, *parent); 

} 

pa rent->Hand 1 eMes sa ge(WM_COWAND_ENABLE, i. LPARAM(Jenablerl): 

void BButtonEnabler::SetCheck(1nt check) 

// note that we ‘don’t* walk the focus chain or try to defer 

( 

// to the application; I’. assigning that lany dialog boxes 

Button->HandleHessage(BM_SETSTYLE. check. MAKELPARAMORUE. «)): 

// are going to have the sane button IDs (eg. IDOK). so 

If (check == BS DEFPUSHBUTTON) 

// conrand enabling needs to be localized to the dialog box 

Button->Parent->HandleMessage(W SETDEFID, tfARAH(Button->Attr.Id)); 

II 

) 

// nor do we disable the conrand if there isn’t a 
// corresponding connand handler; you wouldn’t always want to 

//-IdleActton and DoEnabllng. 

// have a handler for every single check box or radio button 

// Iterates over child window objects, catling tbefr cornand 

// for which you’d constructed an Interface object 

// enablers 

) 

static void DoEnabllngOVIndcw* ctl. void*) 
t 

// we'll get called for all child window objects; make 

) 

BOOL BOIalog::IdleAct1on(long IdleCount) 

// sure we only try to enable those derived fro. TButton 

( 

TButton* button = TYPESAFE_D0MNCAST(ct1, TButton); 

If (1IdleCount) 

ForEach(DoEnabllng); 

if (button) ( 

return TD1a!og::IdleAct1on(1dleCount); 

Window* parent = button->Parent; 

) 

// call a cornand enabler (EV_COtMAND_ENABLE), 

// End of File 
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Listing 2 dialog.h — Header file for dialog.cpp 


// Defines class BDialog, a TDialog descendant that 
// o supports modality via TApplication::BeginModal 
// o supports command enabling of controls 

#if IdefinedC_BDIAL0G_H) 

Mefine_BDIAL0G_H 

class BDialog : public TDialog 
{ 

public: 

BDialogiTWindow* parent, TResId resld, 

THodule* module = 0); 


virtual 

int Executetint flags): 

int 

Execute!) { return Executed); } 

void 

Destroy!int retValue = IDCANCEL); 

void 

CloseWindow!int retValue = IDCANCEL); 

BOOL 

IdleAction!1ong idleCount); 

private: 



BOOL Modality; 


DECLARE_RESPON$E_TABLE(BDialog); 

}; 

#endif // _BDIAL0G_H 

/* End of File */ 


object's IdleActionO, which in turn calls IdleActionO for 
each of its child window objects. The tool bar, a child of 
the main window, performs enabling as part of its IdleAc¬ 
tionO. (Actually, it's part of TGadgetUindow::IdleActionO.) 
The process of enabling event handling for tool bar but¬ 
tons is very similar to the process used for menu items. 

Because tool bar button enablers can be called quite 
frequently (whenever the user pauses, for example), it's 
important that they be very "lightweight." They must be 
short, quick functions or there will be noticeable pauses. 
The same is true for menu item enablers, as a pause 
when the user clicks on the menu bar is quite evident. 

Idle Dialogs 

Since buttons in a dialog box are always visible - just 
as a tool bar is - the best way to enable event handling 
for them is to use idle time - as with tool bars. Unfortu¬ 
nately, modal dialog boxes don't support idle time. When 
you execute a modal dialog box, Windows itself runs the 
message loop, meaning that OWL never has the opportu¬ 
nity to call IdleActionO during idle time. (This isn't a prob¬ 
lem for modeless dialog boxes.) 

Fortunately, OWL has a solution. You can make any 
window or dialog box modal by calling TApplication::Be- 
gi nModal (). Calling Begi nModal 0 is just like calling TDia¬ 
log:: Executed, except that control doesn't return until the 
dialog box calls TApplication::EndModal(). Fellow TeamB 
member Ian Spencer uploaded a sample encapsulation of 
BeginModalO/EndModalO to the BCPPW1N forum on 
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CompuServe. (It's excdlg.zip in library 
#15 - Thanks Ian!) I use a similar 
approach to add IdleActionO support 
to a class derived from TDielog. As 
shown in dialog.cpp (Listing 1) and 
dialog.h (Listing 2), I override Exe- 
cuteO to call BeginModalO and over¬ 
ride Destroy() to call EndModalO. 

Dialog Button Enabling 

With IdleActionO support, I can 
write an idle function to handle the 
enabling. To simplify it, I used the 
ForEachO iterator function. ForEachO 
works with child window objects, 
which means you have to construct 
interface objects for those buttons 
you want to perform enabling for: 


new TButton(this, IDOK); 


The dialog button enabling is similar 
to menu item and tool bar button 
enabling. There are two major differ¬ 
ences: 

1. The dialog button enabler doesn't 
look for a command handler, so it 
won't automatically disable a but¬ 
ton if there isn't a corresponding 
command handler. If it did, you'd 
be forced to write a command enabler for every single 
button you'd constructed an interface object for. 

2. Normal command routing isn't supported, as there'd be 
no way of differentiating between buttons with the 
same ID (such as IDOK) coming from different dialog 
boxes. You must write these command enablers in the 
appropriate dialog class. 

The enabling function in enabler.cpp (Listing 2) is very 
simple: it just uses HandleMessageO to call any existing 
command enabler using the OWL-defined user message 
MM_COMMAND_ENABLE. 

enabler.cpp (Listing 3) contains code for a sample appli¬ 
cation that uses command enablers in a dialog. Complete 
code for the sample application, including the necessary 
resource definition file, is included on the code disk (see 
table of contents for availability). 

Conclusion 

OWL'S command enablers are a handy feature once 
you get used to them. They can do more than just enable 
and disable user interface elements. Don't let the lack of 
documentation scare you; they're well worth the learning 
curve. Being able to extend them to other user interface 
elements like buttons makes them all the more powerful 
and useful. □ 

See page 18 for Listing 3 (enabler.cpp). 
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File Edit Bookmark Help 


r Search | Back | History | uT~li Group | Overview | << | >> 

SetDIqltemText (2.x) 


@void SetDIgItemText( h»nc/D/g idControf. fpsz ) 

HWND hwndDfg 
int idControf; 

LPCSTR fpsz; 


r handle of dialog box 7 
/* identifier of control 7 
/* text to set 7 


Annotate 




There is a bug in Windows that keeps SetWindowText() and 
SetDIgltemTextl) from working correctly when applied to an edit control 
owned by another application. Rather than sending a WM_SETTEXT to the 
edit control as they should, these functions directly tinker with the target 
control's internal window structure to change its title. The bug, then, is 
twofold; 

a) The target window is never notified that it needs to repaint. 

b] An edit control ignores its title, so changing its title does not affect the 
text it contains. 

The workaround is to use SendMessagef) or PostMessageR to deliver a 
WM_SETTEXT to the target window. If you use PostMessageR, make sure 
you pass a string pointer that is somehow guaranteed to still be valid 
whenever the target application gets around to fetching and processing the 
message. 

Reference; p. 71, September 1993 Windows/DOS Developer's Journal 
[Add this annotation to your own online API help file by pressing Alt-E-A] 
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Listing 3 enabler.cpp — Using command enablers in a dialog 


//define JWLPCH 
//include <owl/owlpch.h> 

//include "dialog.h" 

#include "enabler.rh" // supplied on code disk 

class TMyDialog : public BDialog 
{ 

public: 

TMyDialog(TWindow* parent): 

void CeOKtTCommandEnabler& ce); 
void CeCancel(TCommandEnabler& ce); 
void CeCreditDebit(TCommandEnabler& ce): 

protected: 

TCheckBox* EnableOKCheckbox; 

TCheckBox* EnableCancelCheckbox: 

TEdit* AmountEditCtl; 

DECLARE_RESPON$E_TABLE(TMyDialog); 

}; 

DEFINE_RESP0NSE_TABLE1(TMyDialog, BDialog) 
EV_COMMAND_ENABLE(IDOK, CeOK). 

EV_COMMAND_ENABLE(IDCANCEL. CeCancel). 
EV_COMMAND_ENABLE(IDR_CREDIT, CeCreditDebit). 

EV_COMHAND_ENABLE(1 DRJEBIT, CeCreditDebit), 
END_RESPON$E_TABLE; 

TMyDialog::TMyDialog(TWindow* parent) 

: BDialog(parent. DIAL0G_1) 

{ 
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EnableOKCheckbox = new TCheckBoxtthis, IDC_ENABLEOK); 

EnableCancelCheckbox = new TCheckBoxtthis, IDC_ENABLECANCEL); 
AmountEditCtl = new TEdittthis, IDE_AMOUNT); 

// create interface objects for the buttons we want to enable 
II 

new TButtontthis, IDOK); 
new TButtontthis, IDCANCEL): 
new TRadioButtontthis, IDR_CREDIT); 
new TRadioButtontthis, IDR_DEBIT); 


void TMyDialog::CeOK(TCommandEnabler& ce) 

{ 

ce.Enable(EnableOKCheckbox->GetCheck() == BF_CHECKED tl 
AmountEditCtl->GetTextLen() > 0): 

} 

void TMyDialog::CeCancel(TCommandEnabler& ce) 

{ 

ce.Enable(EnableCancelCheckbox->GetCheck() == BF_CHECKED); 
ce.SetText(AmountEditCtl->GetTextLen() ? "Close" : "Cancel"): 


void TMyDialog::CeCreditDebittTCommandEnabler& ce) 
{ 

ce.Enable(AmountEditCtl->GetTextLen() > 0): 

} 


class TMyApp : public TApplication 
{ 

public: 

void InitMainWindowt) 

{ 

SetMainWindowtnew TFrameWindow(0, "Enabler testing")); 
GetMainWindowt)->Assi gnMenu(MENU_l); 

EnableCtl3d(): 

} 

void CmDoItt); 

DECLARE_RESPONSE_TABLE(TMyApp); 

}; 

DEFINE_RESPONSE_TABLEl(TMyApp, TApplication) 
EV_COMMAND(CM_DOIT, CmDoIt), 

END_RESPONSE_TABLE; 

void TMyApp::CmDoItO 
{ 

TMyDi al ogtGetMai nWi ndowt)).Execute(MB_APPLMODAL): 

} 

int OwlMaintint, char*[]) 

1 

return TMyAppO.RunO; 

} 

// End of File 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Heavy Metal Visual C++ 

Programming 

Steve Holzner 

$39.95, includes 3.5" disk 

452 pages 

IDG Books Worldwide, 1994 
ISBN 1-56884-196-5 


IDG is creating a series of 'Heavy Metal' books that 
"provide maximum programming power.' The cover of 
this book contains a picture of a chrome and steel engine 
on what is either a motorcycle or a very high-powered 
riding lawnmower. The cover is also emblazoned with the 
following: 

Slashes to the Corel Your guide to using Visual C++ for 
maximum programming power - plus heavy metal poster 
insidel 

They are not making that up - there really is a heavy 
metal poster bound inside (two, in my review copy). Ap¬ 
parently, IDG's research has revealed less than flattering 
demographics for the C++ programming market: we all 
have the mentality of 14-year-oid boys. I guess they don't 
realize that 14-year-old boys are a lot more likely to just 
rip the poster out and stick it inside their shirts, rather 
than pay for the book. 



Behind the macho facade of its cover, this book is a 
milquetoast, a pantywaist, a 98-pound weakling that had 
better stay off of the beaches that real, sand-kicking Win¬ 
dows programmers frequent. For example, in the chapter 
entitled 'Advanced Graphics, Part I: Bitmaps,' you will 
learn 'something about the difference between logical co¬ 
ordinates and device coordinates." Pretty advanced stuff, 
indeed. I believe a more appropriate title here would be 
Easy Listenin' Visual C++ vi.5 Programming (maybe with a 
John Denver poster inside). Essentially, the book walks 
you through creating a series of tiny Visual C++ programs 
to demonstrate various simple concepts. 

I leafed through the book to see how long it would 
take to find a totally incorrect or misleading statement 
about Windows. It took only three minutes to find the 
author's warning that you shouldn't rely too much on tim¬ 
ers, since 'preempting other tasks with a timer' is real 
bad. In fact, Windows gives timers rather the opposite de¬ 
gree of priority than the author imagines ( UM_TIMER could 
not preempt a flea), a fairly common misconception for 
beginning Windows programmers. For the most part, 
though, I did not see many technical errors, perhaps be¬ 
cause technical prose makes up a relatively small percent¬ 
age of the book. 

On the positive side, the writing is clear, and I believe 
nearly anyone in the world who has written any program 
in any language could sit down with this book and follow 
the examples to create the tiny little programs it describes. 
If you know almost nothing about Windows and C++, 
then this book is for you (but how did you get a copy of 
this magazine?). After reading it, you will still not know 
much, but at least you will have gotten a vague feel for 
what it's like to push the App Wizard buttons and compile 
little Windows programs with Visual C++. 


You can order any of the books that appear in Books in Brief from R8D Publications by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to rdorders@rdpub.com. if using fax or email, send the book title, author, and publisher 
along with your MasterCard or Visa number, expiration date, and phone number. 
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The flashy cover also says there is a 'FREE Disk with 
Full Working Programs.' In fact, there is a big scary, two- 
page license agreement at the back of the book restricting 
what you can do with the software on the disk. Actually, 
only half of the license agreement restricts what you can 
do - the other half is devoted to absolving the publisher 
from any liability if you are silly enough to use their soft¬ 
ware after all. All this to protect an entirely trivial collec¬ 
tion of software, much (if not most) of which was gener¬ 
ated automatically by Visual C++. And the author adds his 
own copyright and reserves all rights on the disk itself. 
Let's all do our part to protect his valuable source code - 
by leaving this book safe and secure on bookstore 
shelves. 


Borland C++ Multimedia 
Programming 

Ori Gurewich and Nathan Gurewich 

$39.99, includes CD-ROM 

903 pages 

Sybex, 1994 

ISBN 0-7821-1550-0 



When I'm looking at a lot of books in succession, small 
things catch my notice sometimes. In this case, I noticed 
that the book started with a warranty statement that 
claimed the enclosed CD-ROM was guaranteed to be free 
of physical defects for only 90 days. How odd ... I used 
to get only a 90-day warranty when I bought a PC, but I 
expected CD-ROMs to last for years. Nowadays, a new PC 
comes with a three-year warranty, but CD-ROMs are ap¬ 
parently losing ground. 

Few programming books that contain more than 900 
pages are filled with text; usually they are heavily padded 
with code. This one is certainly stuffed with code frag¬ 
ments and screen shots, but also fills page after page with 
extremely tedious, detailed instructions for interacting with 
the Borland IDE. Here is a small example of the mind- 
numbing prose: 

Creating the Project and Skeleton Files of the 
Speaker2 Application 

Follow these steps to create a project file for the Speaker2 
application: 

• Select AppExpert from the Project menu of Borland C++ 
Borland C++ responds by displaying the New Project dialog 
box. 

• Use the directory list box of the New Project dialog box 
to select the directory C:\MMBPROG\PRACTICE\CH12. 

• Type Speaker2\Speaker2IDE in the File Name box. 

• Click the OK button of the New Project dialog box. 

Borland C++ responds by displaying the AppExpert Appli¬ 
cation Generation options. 


And on and on. Some degree of this is necessary in trying 
to explain two-dimensional user interface interactions in 
linear text, but this book carries the idea beyond reason¬ 
able limits. It is nearly always assumed that, without step- 
by-step instructions (such as reminding you to press the 
OK button, or to save your files, you will get lost in even 
the simplest dialog boxes. The parts that are not screen 
shots, code fragments, and instructions on how to press 
dialog buttons are mostly devoted to equally minute de¬ 
scriptions of the code fragments, such as telling you that 
the next line in the code declares two integer variables 
that will be used later. 

Still, you might think that, however tedious a read it is, 
after plowing through these 900 pages you will attain 
some competence at Windows multimedia programming. 
Not even close. You see, the book is not really about the 
Windows multimedia programming interface at ail, but 
more about the higher-level interface provided by Te- 
goMM.VBX, a custom control included on the CD-ROM 
(the innovatively bad packaging left a sticky smear on the 
CD when I pulled it out, but it still worked). The VBX puts 
up a big, annoying message box every time you access it, 
but by sending a mere $34.95 to TegoSoft, you can get a 
"professional' version that doesn't do that. Hmmm. 

I have nothing against packaging and marketing soft¬ 
ware in the form of a book, so long as you are up front 
about it. The book's title and cover text represent it as a 
general multimedia text, not one specific to a proprietary 
custom control. The cover text also uses phrases like 
'Complete Source Code.' What a canard! The truth is that 
you do not receive the source code to the most important 
part of the book: the VBX. It's hard to see how the book 
could be less generally useful - it is mostly specific to one 
custom piece of software and to one compiler. A more 
honest title for this book and its CD-ROM would have 
been How to Call Our Multimedia VBX (single-user binary 
with nag screen included). 

The publishers include a statement of their commit¬ 
ment to the environment, noting that their use of recycled 
paper has saved more than 15,300 trees; I have an idea 
how they could have saved a few more. 


ObjectWindows 2.0 Programming 

Tom Swan, with Robert Arnson 
and Marco Cantu 

$44.00, includes 3.5" disk 
550 pages 

Random House, 1994 
ISBN 0-679-79121 -3 


BORtAHP PRiSsI 


ObjectWindows 2.0 
Programming m 



KIMSWAN’NWlJOBtKr AK**)N M4> MANGO CAN1U 

VWM A ftotwwM fcy t-t-et m MHN, 8c-.<»xl fcMMaMkMtl 


Borland's ObjectWindows library (OWL) was fairly radi¬ 
cally overhauled in version 2.0. This book teaches you 
how to develop Windows programs using Borland C++ 
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PROGRAMMING BOOKS 


Hard-to-find titles and titles you won’t find anywhere else 

C++ ■ UNIX ■ ANSI/Standard C ■ Turbo C ■ Windows ■ X Window 



Illustrated C 

By Leor Zolman 

Illustrated C explores the construction of 
several different applications, from start 
to finish. Through a focus on building 
useful, practical programs, this book 
gives the C programmer the "why and 
now" of application design and 
development. Each program is 
exhaustively annotated in a clear, 
readable style. Illustrated C is a tutorial 
for the novice to intermediate 
programmer and a toolbox for all C 
programmers. 

R&D Publications, 1992, 320 pp. 

ISBN 0-923667-21-0 

W36 w/disk.$39.95 



>. 

WINDOWS 

CUSTOM 

CONTROLS 


Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
modular technique that brings structure 
and reusability to Windows application 
designs. Reusing the custom controls 
allows you to focus on the larger design 
issues. 

R&D Publications, 1993, 531 pp. 

ISBN 0-13-034497-4 

W99S w/disk.$55 


IJ.C/OS 

The Real-Time Kernel 



I&.C/OS 

By Jean J. Labrosse 

Labrosse explains the design and 
implementation of his Micro-Controller 
Operating System, a portable, ROMable 
preemptive, real-time, multitasking kernel 
for microprocessors. The system is written 
in C with assembly language code for the 
target microprocessor kept to a minimum. 
It can be ported to any microprocessor 
that provides a stack pointer and allows 
the CPU registers to be pushed onto and 
popped from the stack. It can manage up 
to 63 tasks, with performance comparable 
to many commercially available kernels. 

R&D Publications, 1992, 266 pp 
ISBN 0-13-031352-1 



Object-Oriented Software Engineering 

By Steve Halladay & Michael Wiebel 

This book explains how to engineer 
applications to minimize cost. The 
concise method comprises six phases 
covering the complete software life cycle 
from initial requirements to final 
maintenance. Each chapter discusses a 
major phase, explaining the concepts 
and demonstrating with examples. The 
authors demonstrate object-oriented 
principles for each phase of 
development. For precision, the design 
method is presented in a pseudocode 
recursive algorithm. A comprehensive 
example coded in C++ ties the 
demonstration together, refining the 
example program at each state. 


R&D Publications,1993, 358 pp. 
ISBN 0-13-034489-3 


W62 w/disc. 


$54.90 


T37. 


.$29.95 


. You may FAX your order to 913-841-2624 or 
e-mail it to rdorders@rdpub.com 

All orders must be prepaid in US dollars by check, money order, 
or credit card—MasterCard and VISA are accepted. 


FREE 1994 R&D Technical Book Catalog 

R&D publishes advanced programming books, as well as 
C/C++ Users Journal and Windows/DOS Developer’s 
Journal. Get your complete catalog of R&D programming 
books, along with descriptions of more than 150 useful 
books from a dozen different publishers. 

CALL TODAY — 913-841 - 1631 . 

Or, use the Reader Service card in this magazine. 
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v4.x and OWL v2.0. Theoretically, one could use OWL 
with non-Borland compilers, but that rarely happens in 
practice and there is no attempt in the text to avoid Bor¬ 
land-specific explanations. 

I find this book noteworthy for all of the bad things 
that it does not do. It does not try to teach C++. It does 
not try to teach general Windows programming. It pretty 
much sticks to the topic of teaching you how to use OWL 
to construct Windows programs. That may sound like a 
mundane accomplishment, but believe me, PC program¬ 
ming books that define and stick to a topic that they can 
reasonably hope to cover are in the minority. Just teach¬ 
ing how to use OWL is a plenty ambitious project for one 
book. 

The chapter headings are descriptive enough to give 
an idea of how the book progresses: The Big Picture; Cus¬ 
tomizing a Window with Resources; Generating Code with 
AppExpert; Working with Class Expert; Initializations; Han¬ 
dling Menus; Messages in Windows; Device-Independent 
Graphics; Mouse, Keyboard, and Timer Events; MDI Appli¬ 
cations; Decorating a Window; Using Controls; Dialog 
Boxes; Transferring and Validating Data; VBX Controls; 
Dynamic-Link Libraries; Using Documents and Views; 
Printing and Previewing; Diagnostics. The text is a decent 
mix of conceptual and task-oriented information. There 
are many code fragments, but they are restricted mostly 
to the most relevant portions of the code, and do not 
make up the bulk of the pages, as with so many bad PC 
programming books. The book comes with a code disk 


(butcher knife required) that contains all the source code. 
The disk is unfortunately ambiguous about your right to 
use the code; it says you can use and modify the code, 
but that statement is fairly distant from the unqualified 
copyright notice. 

I could wish for a number of improvements here: more 
information about OWL at the design level, diagrams 
(rather than linear text descriptions) of data structures, and 
so on. The code disk's copyright notice should plainly say 
that you can use the source code in building any applica¬ 
tion. However, the bottom line is that this book takes on 
a complex subject with a good degree of success (a great 
degree compared to the other books in my pile). I highly 
recommend this book if you want to learn how to use 
OWL to construct Windows programs. 



Inside Visual C++, 2nd Edition 

David J. Kruglinski 
$39.95, Includes CD-ROM 
762 pages 
Microsoft Press, 1994 
ISBN 1-55615-661-8 



Micro-Software 


RS232-Toolkit, SuperCom 
for DOS, Windows, NT, OS/2 

for MS C/C++, Visual C++, Turbo/Rorland C/C++, 
Turbo/Borland Pascal (incl. Protected-Ntye), IBM C/C++ 

SuperCom is the development tool for eHfecwig serial communi¬ 
cation software. That means high da^a ^mrtty and highest trans¬ 
mission speed. The SuperCom librari^^je fast even in a multi¬ 
tasking operating system like WindSJ% Windows NT or OS/2. 

The same programming interface isAtsed among different 
languages and operating 


• Interrupt driven: transmission, receptiol 
modem status. Up to 115,200 bps. 

• UARTS: 8250,16450,16550 FIFO. % port address. 

• Simultaneous COM_1 ..COM_36i (©unlimited). • 

• Direct register proarammina* Jn remprsharina. 

• Flow control: RTS/CT^DTjKQBRToN/XOFF and 



MODEM/CRC, 
MfCR, ZMODEM. 
rception handling. 


user defined. ANSIJ 

• Protocols: ASCII, 1 
YMODEM, YMODEM . 

• Timer, Ctrl-Break and E 

• Multitasking support (Windows, NT, OS/2) 

• Protected Mode Interlace, 386-Technology. 

• User Event Routines under DOS and Windows. 

Under Windows user can even post messages to 
the application using PostMessage. 

C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ or Pascal combo pack for Windows+NT only $598 
C/C++ combo pack for DOS+Windows+OS/2 only $799 

C/C++c 1 ' ' -- - - - 

C/C++ c 


Language independent DLL (Windows, NT, OS/2) 
which can be used for simultaneous transfers by 
applications. 

Multiserial board support (AST, ARNET, DigiBoard 
PC/X, HOSTESS, STARGATE). Reduces loading of 
CPU through support of intelligent DigiBoard PC/Xe, 
PC/Xi boards (up to 112 ports’!!!). 

• Modem support, RS422/485 support. 

• Support for 286 DOS-Extender (e.g. PharLap) 

• No resident drivers*. Just link the LIB. No Royalties. 

• FREE technical support. FREE demo 

• Full source code (C or Pascal and optimized ASM). 

• SuperCom++ (C++ or Pascal OOP) included. 

• Protected Mode Interface (Windows) included. 


r UUIIIUU [jaur\ IUI l-wuti.miuvhjtvv;i£. Ulliy<9/99 

i- combo pack for DOS+Windows+NT only $799 
f combo pack for DOS+Windows+OS/2+NT only $999 



’Under DOS and Windows 3.x 


VISA, MC, COD, Check accepted. 


ADONTEC Computer Systems Ltd. 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone: 49-7043-40449 
FAX: 49-7043-40440 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone: 1-707-887-3400 
FAX: 1-707-887-1015 


This book is about Visual C++ vl .5, and it tries to ex¬ 
plain the mechanics of building your application, the MFC 
v2.5 class library, memory management, ODBC, OLE, and 
OLE Automation. I'm sorry to say it does not succeed very 
well. I tried diving in several times in hopes of getting an 
understanding of at least basic MFC concepts, but at last 
gave up. 

The problem with this book is, in short, focus and struc¬ 
ture. The author seems to have an incredible enthusiasm, 
and no topic was unworthy of mention here. Worse, no 
future topic was unworthy of a sentence or two in the 
current topic. Several times I had to stop reading and re¬ 
turn to the beginning of a section because i could not 
figure out when and why the subject had changed. Per¬ 
haps the author had the same difficulty; in some places, 
nearly every paragraph has a bold-faced heading. 

To the degree I could plow through the book, it 
seemed technically accurate; conceptual gaffes (at one 
point, the text claimed that Trans! ateMessageO converts 
UM_LBUn0ND0UN messages into UM_C0MMAND messages) were 
not common. I had the frustrating feeling that the author 
understood the material, but could not organize and ex¬ 
press it coherently. One chapter has the title 'Windows 
Memory Management - Just Say 'New." However, rather 
than just tell the reader to use the large memory model 
and the new operator, the author ends up discussing selec¬ 
tors and descriptors. If you didn't understand Windows en- 
hanced-mode memory management before reading this 
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chapter, you won't understand that subject after reading it. 
But you will lose your train of thought and later wonder 
what exactly selectors and descriptors had to do with 
learning about MFC. 

There are redeeming qualities here. I found the exposi¬ 
tion of OLE's Common Object Model a quite worthwhile 
read (and deserving of more depth, but not in a book 
about Visual C++). Command routing was pleasantly un¬ 
derstandable. I can't say the redeeming qualities add up to 
$40, though. The book comes with a CD-ROM bound with 
the dreaded Microsoft Seal of Submission which, when 
you break it, signifies your acceptance of a one-page, ge¬ 
neric Microsoft license full of legal mumbo-jumbo; I tried 
to read it, but was quickly sapped of the will to live. The 
author claims a copyright as well. Consult your attorney. 

Of books with problems like this, I often wonder 
whether the editor(s) had too little time or were insuffi¬ 
ciently technical, or whether the author assumed his in¬ 
stincts were better and rode roughshod over any editorial 
attempts to restructure, or tighten the focus. This book ac¬ 
tually provides comments on the editor-author relation¬ 
ship (as I said, no topic need be excluded in this shotgun 
style of writing). At one point, the author confides that 
'the Microsoft Press editors told me not to make this sec¬ 
tion sound like a marketing brochure." Hooray for the edi¬ 
tors, I thought. Alas, the author then goes on to say "but I 
couldn't help it," an appropriate epitaph for this vigorous, 
ambitious, but ultimately failed writing effort. 


tainly, there are not enough good diagrams in a typical 
issue of this magazine, so I have a proving ground for 
trying to understand and conquer this problem. 

This book is a how-to guide to programming with Vis¬ 
ual C++ and MFC v2.0. While it is half the size of some 
other Visual C++ books, that is because it is 90 percent 
text and 10 percent code, rather than the other way 
around. The book proceeds through a variety of general 
areas of Visual C++ programming, including: documents 
and views, persistence, general-purpose classes, menus, 
the keyboard, the mouse, cursors, toolbars, dialogs, dialog 
controls, the serial port, Visual Basic controls, graphics, on¬ 
line help, and debugging. In keeping with the title, much 
of the information in the book is practical, hands-on, how¬ 
to information. Some typical headings should give you the 
idea: Appending to a Menu, Updating Menu Changes, 
Counting Menu Items Dynamically, Opening a Serial Port, 
Changing the Cursor, and so on. 

The book comes with a 3.5" disk with more complete 
source code than appears in the book. The back cover of 
the book claims that all the source code is indexed as a 
help file, and that 'all you do is click on a menu item to 
cut and paste code into your application." This sounded 
like a really neat idea. Unfortunately, as far as 1 can tell, 
they just didn't do it. I found only one anemic little help 
file that had about 40 miscellaneous short topics; the top¬ 
ics were mostly about specific MFC functions, and I did not 
see a collection of source code anywhere in the help file. 
Even though the source code is basic and mundane, the 


The Visual C++ Construction Kit 

A Programmer's Resource 

Keith E. Bugg and Jack Tackett, Jr. 

$39.95, includes 3.5" disk 

348 pages 

Wiley, 1994 

ISBN 0-471-00961-X 



VISUAL C++" 
coMsmftucnoN «rr 



Ktm< t * f*C* lAtSKtTt,*. 


When one programmer asks another to explain the de¬ 
sign of some code, it is very likely that they will go to a 
white board and begin drawing diagrams. In person, pro¬ 
grammers use pictures to communicate: circles, squares, 
pointers, hatch marks, data-flow diagrams, structure 
charts, call trees, whatever. When programmers write 
books, however, they use only text to communicate pro¬ 
gramming concepts. This book, for example, has exactly 
one diagram for every 300 pages of text. 

I am not criticizing this book in particular, as every 
book reviewed in this month's column contains virtually 
no diagrams. It's just that this book was useful enough in 
helping me understand MFC that I kept wishing for some 
diagrams to help me over the rough spots. I don't entirely 
understand our desire to always substitute a thousand 
words for every picture, but I plan to think about it. Cer- 


C and C++ DOCUMENTATION 


C-METRIC™ ($59) - Complexity/Quality 

• Calculates "cyclomatic" path complexity for functions and system 

• Counts lines with comments, code, and 'C 1 statements 


filel main 

file2 

— sub2 

fiie2 

1— sub3 

1—sub4 

file2 

filel 

— main(recursv) 

— Ibryl. Ibry2 


C-CALL™ ($69) - Function Hierarchy 

• Tree-Diagram showing function hierarchy 

• Table-of-Contents of functions versus files 

• Summary and detailed cross-reference of functions 


C-CMT™ ($69) - Function Comment 

• Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 



/*FF... 

sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GL06L: var2 var3 


C-LIST™ ($69) - Lists or Reformats 

• Action-Diagrams show logic/control flow 

* Reformats source to various standardized formats 


C-REF™ ($69) - Cross-References Identifiers 

• Local/global/define/parameter summary or cross-reference 

• Produces class-hierarchy tree-diagram for C++ classes 

C-BROWSE™ ($free in C-DOC) - Windows Tree Viewer 

• Graphically view C-CALL function-trees or C-REF class-trees 

C-DOC™ ($199) - DOS/Windows Package ($395 value) 

• All 5 programs integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 10,000 lines 

• Unconditional 30-day money-back guarantee of satisfaction 

C-DOC Professional ($299) - DOS, Windows, OS/2 

• All features of C-DOC, processes 1,000,000 lines, 3-ring binder/case 


!! NEW 6.0 !! Windows Graphic-Tree Viewer 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way OEO 

Mississauga 0NT Voice/Fax (905) 858-4466 

Canada L5N-4M1 Demo/BBS (905) 858-1916 CALL NOW! 
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publisher mindlessly copyrighted and reserved all rights to 
it, using that old 'by opening the seal' voodoo that they 
do so well. 

If you want to use Visual C++ and MFC, I can recom¬ 
mend this book, but it is a lukewarm recommendation. 
The book is strongest when it sticks to its proclaimed 
topic: 'demonstrating how to do the mundane things most 
Windows programmers are called upon to do.' It is 
weaker when it tries to provide a conceptual framework 
for how MFC is structured and for what gives rise to the 
particulars of the how-to information. It also often makes 
authoritative-sounding statements that are quite arguable 
('you cannot use Shift-FI to access Fielp from inside a mo¬ 
dal dialog box'). It does not deliver the level of clear and 
balanced information for MFC that the Swan/Arn- 
son/Cantu book delivers for OWL, but it is definitely more 
understandable and useful than the average entry in the 
crowded pack of Visual C++ books. 



Add Network 
Licensing to Your 
DOS/Windows Apps 
in 2 Hours or Less! 

4^ Convert your unprotected or key 
locked DOS/WIndow App to network 
^ licensing with the LicenseServ toolkit. 


♦ No royalties ♦ Convert demos to paid licenses 

♦ No keys to ship ♦ License as many applications or 

♦ Control concurrent usage modules as you want 



Your customers want floating licenses on their Novell Network. 

If you go with a key based solution you may find yourself spending 
$10,000 a year on keys alone! LicenseServ is a software toolkit 
consisting of: 

♦ Library for your DOS application (DLL for Windows) 

♦ License manager NLM running on the server 

♦ Key-code generator 

The license manager NLM is locked to the 
server's Ethernet address so no key is required. 

You pay one time for the toolkit and license as 
many applications and modules as you want. 

Use LicenseServ to add network licensing to 
your applicaitons and see revenues rise 
dramatically. 

Call for our free eval kit. You can evaluate 
and integrate LicenseServ into your appli¬ 
cation in less than 2 hours! 


VIMAN SOFTWARE, INC. email: info@viman.com 
Tel: (408) 4S9-0678 Fax: (408) 4S8-2862 
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Microsoft Visual C++ Windows 
Primer 

Keith Gurganus and Danny Alexander 
$39.95, includes 3.5" disk 
358 pages 

Academic Press, 1994 
ISBN 0-12-308650-7 



This book was a breeze to read. It took only about half 
an hour, because there are perhaps thirty or forty pages 
of prose here. Flow do you stretch forty pages of prose 
into a 358-page book? Let me count the ways. 

Start with lots of screen shots (why do you think they 
call it 'Visual' C++?). Each screen shot can take up half a 
page, and you can average nearly one screen shot per 
page if you try - there are a lot of dialog boxes in Visual 
C++. Screen shots are such an easy way to fill space, isn't 
there some way to include even more? You betcha. Add a 
40-page appendix that consists of screen shots of all the 
sample applications that come with Visual C++! Sample 
code is a traditional way to pad programming books, and 
Visual C++ can help, since it generates code for you auto¬ 
matically, with plenty of comments and vertical space. Be¬ 
sides using code fragments in the text (when you're run¬ 
ning a little short on screen shots), put more complete 
code in a 70-page appendix behind the appendix of 
screen shots. Before you know it, you've got over 300 
pages and you can use the remainder of your time to 
write some prose to go along with the screen shots and 
code. 

In the opening paragraph of the preface, the authors 
say the book 'is targeted at beginner programmers who 
have some familiarity with the C programming language.' 
The results show, however, that they had no clear idea 
who the audience was, which led to a book that's not 
suitable for anyone. For example, on page 29 they say: 
'All programs start with a set of instructions called source 
code: Can someone who is just learning what source code 
is really be plunged into a C++ program that uses I/O 
streams three pages later? This requires a conceptual leap 
of faith one rarely sees outside of politics. While page 29 
does not assume you know what source code is, page 14 
is utterly convinced that you already know what a make¬ 
file is. And so on. 

The code disk contains the complete source code, 
which the publisher reserves all the rights to. No loss 
there. This is a bad book. I don't think it has any re¬ 
deeming qualities at all. Well, maybe just one: it's easy 
to review. □ 
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Reducing MFC Multi-Document 
Resource Usage 

Walter J. Meerschaert 


;G3= 

Visual C++ vl .5 




In the course of developing a large multi-document OLE server for my com¬ 
pany, I discovered a serious flaw in the MFC library. The problem is that each 
document template you create takes up roughly six percent of the USER heap. 
In a multi-document application like the one I am developing, this can add up 
fast. My application (called PEP) is a graphics front-end for a database of finan¬ 
cial performance numbers. Each of the various kinds of charts (lines, bars, pies, 
etc. - six at last count) has its own document template, and each one is then 
registered in the Im'tlnstanceO routine of my main application class. 

The reason for this memory usage is that when the application starts, MFC 
loads the resources for anything that might be needed through the life of the 
document. It does this even if you never actually create any documents. Why? 
Well, this apparently makes resource allocation more reliable, since everything 
is allocated, there is no chance that a new document will fail to open or fail to 
run in-place due to resource limits in USER. This strategy might also make the 
application run faster (though not by much), since the allocation has already 
been done. Unfortunately, these benefits come at a cost. For an OLE server, 
there are three menus and three accelerators for each document template (with 
a full set of resources for normal editing, in-place editing, and linked file edit¬ 
ing). If your application is both a server and a client, you get an additional 
menu and accelerator. These resources are initialized in the constructor for 
CMultiDocTemplate and CDocTemplate::SetSenerInfo() (see Figure 1). 


Wally Meerschaert is a senior software developer for Callan Associates, Inc., a leading 
pension fund consulting firm in San Francisco. He is the principal author of PEP for 
Windows - a financial performance analysis tool for the institutional investment com¬ 
munity. He can be reached at wallym@callan.win.net. 
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You might argue that, since Win32 does away with the 
resource restrictions in USER, this is a problem that will go 
away by itself. In fact, even with the next version of MFC, 
applications that run in Windows 3.1 under Win32s, or 
even run under Windows 95, will still encounter some lim¬ 
its on the resources in USER, and this will probably remain 
a problem for the next couple of years. 

So, how can you reduce MFCs resource usage? The an¬ 
swer is to derive a template class of your own that shares 
common resources among templates. 


mmBWiw! 
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With Help Magician Pro 3.0, 
you ,can develop online help and 
documents seamlessly in a true 
^WYSIWYG environment much 
like WinHelp. If you have 
manuals or documents, Help 
Magician Pro will import them 
from any popular Windows 
word processor and convert 
them to online help. You can 
simultaneously test your help 
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from a professional help 
authoring tool like support for 
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fool-proof macro editor, multi¬ 
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support, automatic glossary 



Solution 

In PEP (my multi-document OLE server application), all 
of the documents behave at least slightly differently, but 
they all respond to the same commands (this is called 
polymorphism). Thus, all of my menus and accelerators 
are the same across documents. This fact would suggest 
sharing resources among document templates. Your appli¬ 
cation may behave differently, but there is usually a way 
to share at least some of the resources across document 
templates. My class, called CPepDocTemplate, is derived from 
CMultiDocTemplate. Its definition is in 
peptempl.h (Listing 1) and the imple¬ 
mentation is in peptempl.cpp (Listing 
2). Basically, what I have done here 
is to declare a set of static resource 
handles which get loaded the first 
time any instance of the class is cre¬ 
ated. Remember that, in C++, static 
data members are allocated once 
and are available to all invocations 
of a class. 

Flere is what is happening: in the 
constructor in peptempl.cpp, I check 
the common (static) resource handles 
to see if they have been loaded yet, 
and if they haven't, then I load 
them. Afterwards, I assign the han¬ 
dle of the common resources to the 
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Figure 1 MFC resource usage for OLE client/server 

II Excerps from docmultl.cpp: /////////////////////// 

m hAccelEmbedding * NULL; 


m hMenuInPlaceServer = NULL; 

CMultlOocTemplate::CMul tlDocTempIate(UINT nIDResource. 

m_hAccelInPlaceServer = NULL; 

CRuntlmeClass* pDocClass, CRuntimeClass* pFrameClass, 


CRuntlmeClass* pVlewClass) 

1 f ( 1m_str0ocStr1ngs.LoadStrlng(m_nIDResource )) 

iCDocTemplatetnIOResource,pOocClass.pFrameClass.pVlevC 1 ass ) 

TRACElCWarnlng: no docunent names In string for " 

{ 

"template «d\n", nIDResource); 

ASSERT (m docLIst.IsEmptyt )) : 

} 

ASSERTtpOocClass 1= NULL); 



void CDocTemplate::SetServerInfo(UINT nIDOleEmbedding, 

HINSTANCE hlnst = AfxFindResourceHandlel 

UINT nlDOlelnPlaceServer, CRuntimeClass* pOleFrameClass, 

MAKEINTRESOURCE ( nIDResource ) , RT MENU); 

CRuntlmeClass* pOleViewClass) 

m hMenuShared = ::LoadMenuEhlnst. 

{ 

MAKEINTRESOURCE(nlDResource)): 

if (nIDOleEmbedding 1= 8) 

m hAccelTable = ::LoadAccelerators(hInst. 

{ 

KAKEINTRESOURCE(nlDResource)); 

// load menu for editing an embedding (as a server) 

m nUntltledCount = 8; // start at 1 

HINSTANCE hlnst = AfxFindResourceHandlel 

} 

MAKEINTRESOURCE(nlDOleEmbedding). RTJENU); 


m_hMenuEmbedding = ::LoadMenu(hInst. 

// Excerpts from doctempl.cpp: ////////////////////// 

MAKEINTRESOURCEInIDOl eEatedding )) ; 


m hAccelEmbedding = ::LoadAccelerators(hlnst. 

CDocTemplate;rCDocTemplate(UINT nIDResource, 

MAKEINTRESOURCEInIDOleEmbedding )) ; 

CRuntimeClass* pDocClass, CRuntlmeClass* pFrameClass, 

) 

CRuntlmeClass* pViewClass) 


t 

if (nlDOlelnPlaceServer != 8) 

ASSERT VALID IDR(nlDResource); 

( 

ASSERTtpFrameClass 1= NULL); 

// load menu for editing in-place (as a server) 


HINSTANCE hlnst = AfxFindResourceHandlel 

m nIDResource * nIDResource; 

MAKEINTRESOURCEtnIDOleInPlaceServer), RT MENU); 

m_pDocClass = pDocClass; 

m hMenuInPlaceServer = ;;LoadMenu(hInst, 

m_pFrameClass = pFrameClass; 

MAKEINTRESOURCEInID01elnPlaceServer) ) ; 

m_pViewClass = pVlewClass; 

m hAccelInPlaceServer = ;:LoadAccelerators(hInst, 

m_p01eFrameClass = NULL; 

MAKEINTRES0URCE(nID01elnPl aceServer)); 

mjOleVietflass = NULL; 

) 


m_p01eFrameClass = pOleFrameClass; 

mjAttachedFactory = NULL; 

iLpOleViewClass = pOleViewClass; 

m hHenuInPlace = NULL; 

iLnIDServerResource = nlDOlelnPlaceServer; 

m hAccelInPlace * NULL; 

) 

m_hHenuEmbedding = NULL; 
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Listing 1 peptempl.h -— Definition of 
shared-resource document template 


II peptempl.h - doc templates that share menu & accel 
// across Invocations 

#1fndef PEPTEMPL_H__ 

♦define _PEPTEMPL_H_ 

class CPepDocTemplate : public CMultIDocTemplate 
{ 

DECLARE_DYNAMIC(CPepDocTemplate) 

// Constructor 
public: 

CPepDocTemplate(UIMT nIDResource,CRunt1meClass*pDocCls); 

//Implementation 

public: 

II coamon menu/accelerator rsrcs for In-place container 
static HMENU m_hMenuInPlaceCaimon; 
static HACCEL m_hAccelInPlaceConmon; 

// coamon menu/accelerator rsrc for server editing embedding 
static HMENU m_hMenuEmbedd1ngComnon; 
static HACCEL BLhAccelEmbeddlngCoamon; 

// coamon menu/accelerator rsrc for server editing In-place 
static HMENU mJiMenuInPlaceServerCommon; 
static HACCEL m_hAcce!InPlaceServerCommon; 

// coamon menu/accel table for MDI Child windows of this type 
static HMENU m_hMenuSharedCoamon; 
static HACCEL m_hAccelTableCoamon; 

virtual -CPepOocTemplateO: 

}; 


lendlf //_PEPTEMPL_H_ 

/* End of File */ 


□ Request Reader Service #200 □ 


specific resources. The destructor merely deletes the com¬ 
mon resources if they haven't been deleted already, and 
NULLs out the specific resource handles. 

The only hitch with this method is that the compiler 
generates the following error: 

c:\pepgraph\dev\peptempl.cpp(27) : error \ 

C2512: 'CMultiDocTemplate' : no \ 
appropriate default constructor available 

This occurs because Microsoft, in its wisdom, didn't supply 
a default constructor other than those in Figure 1. Thus I 
had to do the unthinkable and edit afxwin.h to add the 
appropriate in-line default constructors, as shown in Figure 
2. If you ever decide to do something like this, copy the 
file to your project directory and edit that copy. You can 


Listing 2 peptempl.cpp — Implementation of 
shared-resource document template 


II CPepDocTemplate implementation 

// mainly here to allow the sharing of resources between PEP 
// doc types. I had to change the afxwin.h file to add empty 
// default constructors to the base classes 

♦include "stdafx.h” 

♦include "peptempl.h" 

♦include <afxpriv.h> 

♦include "pepview.h" 

♦include "ipframe.h” 

IMPLEMENT_DYNAMIC(CPepDocTemplate. CMultiDocTemplate) 

♦define new DEBUGJEW 


HMENU CPepDocTemplate::m_hMenuInPlaceCommon * NULL: 

HACCEL CPepDocTemplate::m_hAccelInPlaceCommon = NULL: 

HMENU CPepDocTemplate::m_hMenuEmbeddingCommon = NULL: 

HACCEL CPepDocTemplate::m_hAccelEmbeddingCommon * NULL: 
HMENU CPepDocTemplate::m_hMenuInPlaceServerCommon = NULL; 
HACCEL CPepDocTemplate::m_hAccelInPlaceServerCommon = NULL; 
HMENU CPepDocTemplate::m_hMenuSharedCommon = NULL; 

HACCEL CPepDocTemplate::m_hAccelTableCommon * NULL; 


CPepDocTemplate::CPepDocTemplateCUINT nIDResource. 

CRuntimeClass* pDocClass) 

{ 

ASSERT_VALID_IDR(nIDResource); 

ASSERT(m_docList.IsEmptyC)); 

ASSERT(pDocClass 1 = NULL); 


mjiIDResource 

m_pDocClass 

m_pFrameClass 

m_pViewCl ass 

m_p01eFrameClass 

m_p01eVI ewCl ass 

m_nID$erverResource 


= nIDResource; 

« pDocClass; 

= RUNTIME_CLA$$(CMDIChildWnd); 
= RUNTIM£_CLASS(CPepwinView); 

= RUNTIME_CLASS(CInPlaceFrame); 
= RUNTIME_CLASS(CPepwi nVi ew); 

= IDR_CHART_SRVR_IP; 


m_pAttachedFactory * NULL; 

HINSTANCE hlnst = AfxGetResourceHandleO; 
if (mJiMenuEmbeddingCommon «« NULL) 

mJMenuEmbeddingCommon = ::LoadMenu(hInst, 

MAKEINTRESOURCE!IDR_CHART_SRVR_EMB)); 
if (mJiAccelEmbeddingCommon == NULL) 

mJiAccelEmbeddingCommon = :: LoadAccel eratorsihlnst, 

MAKEINTRESOURCEtIDR_CHART_SRVR_EMB)); 
if (mJiMenuInPlaceServerCommon == NULL) 

mJiMenuInPlaceServerCommon = ::LoadMenu(hInst, 

MAKEINTRESOURCECIDR_CHART_SRVR_IP)); 
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make your program access the copy by changing the first 
line in stdafx.h from 

^include <afxwin.h> 
to 

//include "afxwin.h" 

The two lines I added to afxwin.h are marked in Figure 2 
with the comment 7/*WJM*'. These two lines are the ex¬ 
tent of the changes I had to make to get my code to 
compile. They are added as inline constructors when the 
file peptempl.cpp is compiled; they don't affect the com¬ 
piled MFC library files in any way. (Of course, by changing 
the library header file I now have one more thing to keep 


Listing 2 continued 


If (m_hAccelInPlaceServerCommon ** NULL) 

m_hAcce1InPlaceServerCommon = ::LoadAccelerators(hInst, 
MAKEINTRESOURCECIDR_CHART_SRVR_IP)); 


= NULL 
= NULL 
= NULL 
= NULL 


// document view 


// OLE container 


m_hMenu$hared 
m_hAccelTable 
mJiMenuInPlace 
m_hAccel InPl ace 
// OLE server 
mJiMenuEmbedding 
m_hAccelEmbedding 
// OLE server InPlace 
m_hMenuInPlace$erver = mJiMenuInPlaceServerCommon; 
mJiAccelInPlaceServer= mJiAccelInPlaceServerCommon; 
if (lm_strDocStrings.LoadString(m_nIDResource)) 

TRACElCWarning: no document names in string for ” 

"template #%d\n", nIDResource); 
m_nUntitledCount = 0; // start at 1 


= mJiMenuEmbeddingCommon; 

= mJiAccelEmbeddingCommon; 


CPepDocTemplate::~CPepDocTemplate() 

{ 

// delete common resources 
if (mJiMenuInPlaceCommon != NULL) 

::DestroyMenu(mJiMenuInPlaceCommon); 
if (mJiAccelInPlaceCommon 1= NULL) 

::FreeResource(m_hAccelInPl aceCommon); 
if (mJiMenuEmbeddingCommon 1= NULL) 

:: DestroyMenu(m_hMenuEmbeddingCommon); 
if (mJiAccelEmbeddingCommon 1= NULL) 

::FreeResource(m_hAccelEmbeddingCommon); 
if (mJiMenuInPlaceServerCommon != NULL) 

::DestroyMenu(m_hMenuInPlace$erverCommon); 
if (mJiAccelInPlaceServerCommon != NULL) 

::FreeResource(m_hAccelInPlaceServerCommon); 
if (mJiMenuSharedCommon != NULL) 

::DestroyMenu(mJiMenu$haredCommon); 
if (m_hAccelTableCommon != NULL) 

::FreeResource((HGLOBAL)m_hAccelTableCommon); 

// set other resources to NULL to avoid trying to 
// delete something that isn't there 


mJiMenuInPlace 

= NULL; 

mJiAccelInPlace 

= NULL; 

mJiMenuEmbedding 

= NULL; 

mJiAccelEmbeddi ng 

= NULL; 

mJiMenuInPlaceServer 

= NULL; 

mJiAccelInPlaceServer 

NULL; 

mJiMenuShared 

= NULL; 

mJiAccelTable 

= NULL; 


} 

// End of File 


Figure 2 Modifying afxwin.h to add default 
constructors 


II from modified afxwin.h 

class CDocTemplate : public CCmdTarget 
{ 

DECLARE_DYNAMIC(CDocTemplate) 

// Constructors 
protected: 

CDocTemplateiUINT nIDResource, CRuntimeClass* pDocClass, 
CRuntimeClass* pFrameClass, CRuntimeClass* pViewClass); 

CDocTemplate(){}; // *WJM* 

< more stuff deleted > 

}; 

// MDI support (zero or more documents) 
class CMultiDocTemplate : public CDocTemplate 
{ 

DECLAREJ)YNAMIC(CMultiDocTemplate) 

// Constructors 
public; 

CMultiDocTemplate(UINT nIDResource, 

CRuntimeClass* pDocClass, CRuntimeClass* 

pFrameClass, CRuntimeClass* pViewClass); 
CMultiDocTemplate(){}; // *WJM* 

< more stuff deleted > 

}; 
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Figure 3 Fragment from the Microsoft “scribble" 
example 


11 from scribble.cpp 

CMultiDocTemplate* pDocTemplate; 
pDocTemplate = new CMultiDocTemplate( 

IDRJCRIBTYPE. RUNTIHE_CLASS(CScribDoc), 

// MDI child frame w/splitter wnd 
RUNTIME_CLASS(CScribFrame). RUNTIME_CLASS(CScribView)); 
pDocTemplate->SetServerInfo(IDR_SCRIBTYPE_SRVR_EMB, 

IDR_$CRIBTYPE_$RVR_IP, RUNTIME_CLASS(ClnPl aceFrame)): 
AddDocT emplate(pDocTemplate); 
m_server.ConnectTemplate(clsid, pDocTemplate, FALSE); 


Figure 4 Example of using modified document 
class 


from myapp.cpp 

// Line Charts . 

CPepDocTemplate* pPWLineChartDT; 

pPWLineChartDT = new CPepDocTemplate(IDR_L1NECHART, 

RUNTIME_CLASS(CPWLineChartDoc)); 
AddDocTemplate(pPWLineChartDT); 

m_LineChartServer.ConnectTemplate(clsidLC, pPWLineChartDT, FALSE); 


track of when I move to a new version of the library, but I 
can handle that.) 

How, then, are these classes incorporated into the ap¬ 
plication? Perhaps the best way to illustrate their use is to 
compare the MFC Scribble example in Figure 3 with the 
example from PEP in Figure 4. Notice that the call to Set- 
ServerlnfoO has been eliminated. Since I don't need the 
extra flexibility offered by the base classes, I was able to 
fold the SetServerlnfoO routine into the constructor. Notice 
also that there are fewer arguments to my constructor - 
since the resources all share the same names, there is no 
reason to pass them in, I just hard-coded them into the 
constructor. The result is more readable (and therefore 
more maintainable) code. 


What is the effect of these changes on my resource 
usage? The first document template I create takes up six 
percent of the USER heap, just as before. However, ail sub¬ 
sequent document templates I create take up almost 
none. 

Summary 

By using my own document templates, derived from 
the MFC supplied ones, and modifying the afxwin.h header 
file, I was able to reduce my resource usage from 30 per¬ 
cent of the total heap to less than 7 percent. Your results 
may vary. □ 
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Roger Alley is an independent contractor in the Bay Area, and is currently involved with 
projects at Open Horizon, Intuit, and Lotus Development. He can be reached on Com¬ 
puServe at 71163,2407. 


Fixing Bugs in the Common 
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The common dialog DLL (cornidlg.dll), which provides a standard look for 
common functions such as opening files and choosing colors, has become 
enormously popular. Equally popular is the CTL3D DLL (ctl3d.dll), a Microsoft 
DLL that gives a 3-D look to dialogs and the standard Windows controls. Ail is 
not roses with these two DLLs, however. When you use the common dialog 
functions ChooseCoiorO and ChooseFontO in conjunction with CTL3D, you will 
run into bugs in comidlg.dll. The basic problem is flawed repainting logic in 
coimdlg.dll, which leaves areas painted in the wrong colors when you are also 
using ctl3d.dll. Also, the ChooseColor dialog has a fatal bug whether you use 
it with CTL3D or not - just clicking the mouse in the wrong place in the dialog 
(see Figure 1) can produce a GP faultl This article explains these bugs in the 
Common Dialogs and then shows you how to fix them. 

The ChooseCoiorO GP Fault 

The worst common dialog bug is also the easiest to demonstrate. If you 
happen to have an application that calls ChooseCoiorO (note that none of the 
standard small applications that ship with Windows uses it - they roll their 
own), just bring up the dialog and click exactly two or three pixels to the left of 
any of the Basic or Custom color boxes on the left side of the dialog. Because 
this bug results in a wild memory read from coimdlg.dll's data segment, and 
because this segment may grow due to local heap allocations, you may have 
to restart Windows (and avoid bringing up any of the other common dialogs) 
in order to actually encounter the GP fault, but this doesn't change the fact that 
the code is faulty, and the potential for a crash is very real. Other things may 
go wrong as well. For example, when I was unable to generate the fault, I 
usually could get the DLL to draw some faint white lines close to the top and 
left side of the dialog by clicking just to the left of the very first color box. 
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Figure 1 Where to find bugs in the ChooseColor dialog 
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The source of the crashing bug in the ChooseColorO 
function turned out to be quite interesting. The dialog it¬ 
self contains two static controls (with IDs of 720 and 721) 
that 'cover' the two sets of color boxes on the left side of 
the dialog (the Basic Colors and the Custom Colors). Noth¬ 
ing is drawn for these controls, so they're not actually vis¬ 
ible, but they are used to determine the location and size 
of the individual color boxes (which are not separate con¬ 
trols), as well as to test for mouse clicks within the win¬ 
dow (by using ChildUindouFromPointO and comparing the 
result to the static controls' window handles). These con¬ 
trols also allow the user to tab into those locations and 
move around the color boxes with the arrow keys (this 
later functionality is accomplished by subclassing the static 
window procedure). The first color box in each of the two 
groups is drawn three pixels below and to the right of the 
associated static control window's upper left point, and 
there is a fixed gap of five pixels between each color box 
(in both the horizontal and vertical direction). 

When the user presses the primary mouse button (or 
drags the mouse) over the area, and this mouse action 
passes the ChildUindouFromPointO test mentioned above, 
the code attempts to determine which of the individual 
boxes the mouse is actually over. The basic algorithm it 
uses is to calculate the proper row and column, and then 
construct the 'box_id' from the formula ((row * 8) + col¬ 
umn). The row and column, in turn, are calculated by tak¬ 
ing the mouse position relative to the upper left of the first 
color box in the group, and dividing by the gap between 


Listing 1 Code to patch bugs in the common 
dialogs 


II Sample code to demonstrate patching COMMDLG.DLL to overcome 
// bugs in the ChooseColorO and ChooseFontO functions 

^include <windows.h> 

#include <commdlg.h> 

^include <string.h> // for _fmemset() 

// main program sets to TRUE if CTL3D lib loaded, 

extern BOOL bCtl3d; 

static BOOL bColorPatched; 

static BOOL bFontPatched; 

static BYTE saved_patch[16]; 

UINT FAR PASCAL _export hook_choose_color 
(HWND hWnd, UINT message. 

WPARAM wParam. LPARAM IParam); 

UINT FAR PASCAL _export hook_choose_font 
(HWND hWnd, UINT message. 

WPARAM wParam. LPARAM IParam); 


void PASCAL test_choose_color (HWND hWndMain, 

BOOL bPatch, COLORREF FAR *custom_colors) 


{ 


CH00SEC0L0R choose_color; 


// Initialize our structure 

_fmemset (&choose_color, 0, 

choose_color.lStructSize 

choose_color.hwndOwner 

choose_color.hInstance 

choose_color.rgbResult 

choose_color. lpCustColors 


sizeof(CHOOSECOLOR)); 

= sizeof(CHOOSECOLOR); 
= hWndMain; 

= NULL; 

= 0 ; 

= custom_colors; 
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adjacent color boxes (from upper left point to upper left 
point). For example, if the horizontal gap between color 
boxes is 29 pixels (meaning the color box is 24 pixels 
wide, with 5 pixels between the boxes), and the first color 
box is at client position (10, 26), and the mouse goes 
down at x location 84, the column would be set to (84 - 
10)/ 29 = 2, i.e., the third color box across. 

The above calculation uses unsigned operations. Unfor¬ 
tunately, the ChildUindowFromPointO test allows mouse 
clicks within the three pixels of the top or left of the color 
box groups to fall through, and the result in these cases is 
a negative numerator. For example, if the mouse is 
pressed at x location 8, the resulting calculation becomes 
(8 - 10) / 29 = 65534 / 29 = 2259. This is somewhat out of 
range, but the program proceeds along as if it were valid. 
The result is a very large boxjd that later gets used as an 
index into an array of 64 rectangles (representing the ac¬ 
tual location of the 64 individual color boxes) to draw the 
black selection and focus rectangles. If the data segment 
isn't large enough, the result is a GP fault and the unsus¬ 
pecting application bites the dust. 

The commdlg.dll code does a couple of things to mask 
this problem. First of all, it checks each mouse click to see 
if it is past the right or bottom of the last color box in the 
group, and if so, ignores it. It also checks to see if the click 
is between the individual color boxes, ignoring those 
clicks where the division remainder from the calculation is 
greater than or equal to the actual size of the color box. 
Using the same numbers as above, a mouse click at x 
location 34 is ignored, because (REMAINDER ((34- 10)/ 29) 
= 24 is greater than or equal to 29-5 = 24. Mouse clicks 
at locations 35-38 are likewise ignored. 

This last test effectively hides the problem whenever 
the y position is above the top of the group, as well as 
when the x position is 1 pixel to the left of the group, but 
only because of chance. No matter what resolution I put 
my driver in (although I didn't try using Large Fonts), the 
first color box always began at location (10, 26), and each 
color box was always 24 pixels wide and 17 pixels high. 
Just by chance, the remainder of (23 - 26) / (17 + 5) = 
65533 / 22 is 17, which falls into the 'between boxes' 
range. The same is true for y locations 24 and 25, and x 
location 9 ((9 - 10) / (24 + 5) leaves a remainder of 24). 
Pure luck, but probably bad luck - had the procedure 
crashed more frequently, it's much more likely the bug 
would have been caught and fixed before release. As it is, 
it only fails at x locations 7 and 8, or 3 and 2 pixels, 
respectively, left of the group. 

The Common Dialog Repainting Bug 

ctl3d.dll can automatically subclass dialogs like the 
common dialogs and give the controls a 3-D look. This 
produces visual problems in both the ChooseColor and 
the ChooseFont dialogs. In the ChooseColor dialog, you 
can see these drawing errors by clicking on any of the 
color boxes on the left side of the dialog - the color box 
that was previously selected gets two extraneous white 
rectangles drawn around it (see Figure 1). You get a simi¬ 
lar painting problem when you click on the right side, 


Listing 1 continued 



choose_color.Flags = CCJULLOPEN I <(bPatch) 

7 CCJNABLEHOOK : 0); 

choose_co1or. 1 CustOata = 0: 

choose_color.1pfnHook = (bPatch) 7 

hook_choo$e_color : NULL; 
choo$e_color.lpTemp1ateName = NULL; 

// Do the dialog 
bColorPatched ■ FALSE; 

ChooseColor (ichoose_color); 

// If the patches didn’t get un-applied, do so now 
if (bColorPatched) 

hook_choose_color (NULL, tMACTIVATE, FALSE. 0); 


lifdef_BORLANDC_ 

#pragma argsused 
#endif 

UINT FAR PASCAL _export hook_choose_color (HWND hWnd. 

UINT message. WPARAM wParam, LPARAM IParam) 

{ 

UINT code_selector, data_selector; 

LPBYTE IpPatchl. lpPatch2, lpPatch3, lpPatch4, lpPatch5; 
WORD i; 

// Ne’re only Interesed in activation events 
if (message 1= WM_ACTIVATE) 
return 0; 

// Make sure segment is as large as needed for our tests 
code_selector = HIWORD(ChooseColor); 
if (GetSelectorLimit (code_selector) < 0xlDAC) 
return 0; 

// Get writable selector for segment we need to write to 
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Listing 1 continued 


data_selector * AllocSelector (code_selector): 
if (!data_selector) 
return 0 ; 

if (PrestoChangoSelector (code_se1ector. data_$elector)) 
{ 

// Calculate the addresses we need to write to 
IpPatchl * MAKELP(data_selector. 0xl05F): 

1pPatch2 = MAKELP(data_selector. 0xl0EF); 
lpPatch3 = MAKELP(data_selector. 0xlD9C): 

1 pPatch4 * MAKELP(data_selector. 0X058B); 
lpPatch5 = HAKELP(data_selector. 0X05A1); 

// Are we being activated or de-activated? 
if (wParam) 

{ 

// Make sure we're patching the correct code 
if <(lpPatchl[l] == 0x05) 44 
(IpPatchl[2] == 0x00) 44 
(1pPatch2[l] == 0x05) 44 
(1pPatch2[2] == 0x00) 44 
(lpPatch3[0] == 0xFF) 44 
(lpPatch3[l] *• 0x76) 44 
(lpPatch3[2] == 0x06)) 

{ 

// Fix the segment, and apply the patches 
// (and save some code) 

Global Fix ((HGLOBAL)code_selector); 
if (bCtl3d) 

{ 

1pPatchlCl] = 0x0F; 
lpPatch2[l] = 0x0F; 
for (i=0;i<9:i++) 

( 

saved_patch[1] * lpPatch3[i]; 
lpPatch3[i] = 1pPatchl[i]; 

) 

for (i=9:i<16;i++) 

{ 

saved_patch[i] = lpPatch3[i]; 
lpPatch3[i] = 0x90; 

) 

} 

lpPatch4[0] = lpPatch5[0] = 0x99; 
lpPatch4[l] ■ lpPatch5[l] * 0x90; 
lpPatch4[3] = lpPatch5[3] = 0x3E; 
bColorPatched * TRUE; 

) 

) 

else 

{ 

// If previously patched, un-apply them now 
if (bColorPatched) 

( 

// Un-apply patches, and un-fix the segment 
if (bCtl3d) 

( 

lpPatchl[l] - 0x05: 
lpPatch2[l] = 0x05; 
for (i= 0 ;i< 16 ;i++) 

lpPatch3[i] * saved_patch[i]; 

) 

lpPatch4[0] = lpPatch5[0] = 0x2B; 
lpPatch4[l] = lpPatch5[l] * 0xD2; 
lpPatch4[3] = lpPatch5[3] = 0x36: 

G1obalUnfix ((HGLOBAL)code_selector); 
bColorPatched = FALSE: 

) 

) 

) 

// Free the selector we allocated, and we’re done 
FreeSelector (data_selector); 
return 0; 


void PASCAL test_choose_font (HWND hWndMain. BOOL bPatch) 

{ 

LOGFONT If; 

CHOOSEFONT choose_font; 


// Initialize the CHOOSEFONT structure 
_fmemset (4choose_font, 0. sizeof(CHOOSEFONT)); 
choose_font.1StructSize » sizeof(CHOOSEFONT); 

choose_font.hwndOwner * hWndMain: 

choose_font.lpLogFont * 41 f; 

choosejont.Flags = CFJCREENFONTS I 

((bPatch 44 bCtl3d) 7 CF_ENABLEH00K : 0); 
choose_font.1pfnHook * (bPatch 44 bCtl3d) 7 

hook_choose_font : NULL; 

// Do the dialog 
bFontPatched = FALSE; 

ChooseFont (4choose_font); 

// If the code is still patched, un-patch it now 
if (bFontPatched) 

hook_choose_font (NULL, WM_ACTIVATE, FALSE, 0); 


#ifdef _BORLANDC_ 

♦pragma argsused 
lendif 

UINT FAR PASCAL _export hook_choose_font (HWND hWnd. 

UINT message. WPARAM wParam. LPARAM IParam) 

{ 

UINT code_selector. data_selector; 

LPBYTE IpPatchl; 

// We're only interested in activation events 
if (message I- WM_ACTIVATE) 
return 0; 

// Make sure segment is as large as needed for our tests 
code_selector » HIWORD(ChooseFont); 
if (GetSelectorLimit (code_selector) < 0x22B0) 
return 0; 

// Get writable selector for segment we need to write to 
data_selector * AllocSelector (code_selector); 
if (ldata_selector) 
return 0; 

if (PrestoChangoSelector (code_selector. data_selector)) 

{ 

// Calculate the address we need to write to 
IpPatchl = MAKELP(data_selector, 0x22AD); 

// Are we being activated or de-activated? 
if (wParam) 

( 

// Make sure we're patching the correct code 
if ((IpPatchl[1] ** 0x05) 

44 OpPatchl[2] « 0x00)) 

( 

// Fix the segment and apply the patch 
G1obalFix ((HGLOBAL)code selector); 
lpPatchl[l] = 0x0F; 
bFontPatched = TRUE; 

) 

) 

else 

{ 

// If we previously made patch, un-apply it now 
if (bFontPatched) 

{ 

// Un-apply the patch and un-fix the segment 
1pPatchlCl] * 0x05; 

Global Unfix ((HGLOBAL)code_selector); 
bFontPatched = FALSE; 

) 

} 

) 

// Free the selector we allocated, and we're done 
FreeSelector (data_selector); 
return 0; 


/* End of File */ 
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where the luminosity slider control is. In the ChooseFont 
dialog, the problem appears in the large white box within 
the Samples group box (although some people may not 
consider this to be a problem). 

To understand why painting problems arise with the 
common dialogs, you have to understand the normal flow 
of dialog repainting, because ctl3d.dll depends on that 
flow to give dialogs a 3-D look. When you create a dialog, 
the dialog manager normally repaints the dialog back¬ 
ground for you, but it gives you a way to customize that 
repainting. When the dialog window receives a 
UM_ERASEBKGND message, it sends your dialog procedure a 
UM_CTLC0L0R message with control type of CTLC0L0R_DLG. 
Your dialog procedure can return a brush for this message 
in order to give the dialog background a gray color (as 
ctl3d.dll does), create a brushed steel look (as with Bor¬ 
land's dialog), or create other special effects, ctl3d.dll 
uses this message to make sure the dialog background is 
painted gray. 

Unfortunately, the ChooseColor common dialog code 
does some of its own custom drawing and, instead of is¬ 
suing a UM_CTLC0L0R to ask what the desired background 
color is for the dialog, it simply calls GetSysColor 
(C0L0R_UIND0U), and then creates a pen or brush with the 
color returned in order to draw onto the dialog back¬ 
ground. The result depends on the color scheme your 
desktop is using, but it is typically extraneous white areas 
(as shown in Figure 1) that should be gray. 

Dealing with Common Dialog Bugs 

Unfortunately, there's no good way to avoid these 
problems without abandoning one of the DLLs. In addi¬ 
tion, there is almost no chance of Microsoft upgrading the 
common dialogs, for a number of reasons. The first, of 
course, is that Windows 95 is on the horizon, and the 
functionality provided by commdlg.dll and ctl3d.dll will al¬ 
most surely change in that version. In addition, the Choose - 
FontO problem is not ail that serious, and neither the 
ChooseFont nor the ChooseColor dialog is used by nearly 
as many applications as the OpenFile and SaveAs dialogs. 
Finally, although most current Microsoft applications pre¬ 
sent the same look as the common dialogs do, they don't 
actually use.commdlg.dll (they have, in effect, rolled their 
own). So, in this case, I doubt if you can look to the 
provider to fix the problem. 

Thus, if you want to work around these problems, 
there is no alternative but to provide a custom solution. 
The first approach I took to solving this was to use the 
hook mechanism provided by the common dialogs, which 
gives the programmer a chance to view and process any 
dialog messages before the actual dialog procedure. It 
quickly became apparent, however, that fixing the prob¬ 
lems in this way would require not only writing a lot of 
code, but also using a lot of undocumented information 
about how the common dialog procedures specifically 
work, including the private data structures they work with. 

On the other hand, I could see that simply patching the 
code at runtime would be very simple, and would require 
only that I properly recognize the version of coimdlg.dll 


being used and that I know where and how to patch each 
version. As I'm only aware of a single version of this DLL, 
determining if I was using the proper version was rela¬ 
tively simple - either it's the version I want, or it's not (in 
which case I do nothing). Determining exactly what to 
patch was a bit more difficult. 

Many people, of course, have the firm belief that code 
patching is a technique to be avoided at all costs. In this 
case, however, the only other alternative appears to be 
completely rewriting the dialog, and rewriting either the 
ChooseFont or ChooseColor dialog is not an insignificant 
task. I wouldn't hesitate to use the patching technique pre¬ 
sented here, versus spending a month or more reinvent¬ 
ing the wheel. 

Fixing the Painting Problems 

As mentioned earlier, most of the painting problems re¬ 
late to the fact that the code does not issue the 
UM_CTLC0L0R message appropriately, but instead just uses 
GetSysColor(COLOR_MINDOU), and then creates a pen or brush 
with the color returned in order to draw onto the dialog 
background. If I were actually correcting the source code, I 
would obviously issue the VM_CTLC0L0R message, and then 
do the drawing properly. This would be necessary to en¬ 
sure that the code worked regardless of whether or not 
ctl3d.dll was being used. Because the current code uses 
the color returned in different ways (such as a brush or 
pen), while the UM_CTLC0L0R message basically returns a 
brush handle, doing this properly would have required 
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replacing more code than I was pre¬ 
pared to do (and would have re¬ 
quired more intimate knowledge, as 
explained earlier). Instead, since each 
of these problems involved drawing 
the dialog background, and since 
ctl3d.dll simply uses a different sys¬ 
tem color for drawing the back¬ 
ground (specifically, C0L0R_BTNFACE], I 
just decided to replace the GetSy- 
sColor(COLORJHNDOV) calls with a Get- 
SysColor(COLOR_BTNFACE). 

In three of the four problem areas, 
performing this change involved a 
change of a single byte. In one of the 
bug locations, the call to GetSy- 
sColorO had already been done (be¬ 
fore I could intercept it), and the re¬ 
sult had been stored in a global vari¬ 
able. Then, when the drawing was to 
be done, it executed the statement 
GetNearestColorihdc, global_var). I 
simply replaced this statement with 
GetSysCo 1 or( C0L0R_BTNFACE), and a 
bunch of NOPs. 

Fixing the ChooseColorO 
GP Fault 

There are a couple of ways the 
ChooseColorO GP fault could be 
avoided. An easy way would prob¬ 
ably be to simply move the static 
control windows down and right 3 
pixels. This would cause the function 
to ignore the mouse clicks when the 
ChildUindowFromPointO test failed. 
However, since I had already decided 
to simply patch the actual code for 
the CTL3D drawing problems, it 
seemed logical to do the same for 
this problem. In order to do this, I 
changed the division to be a signed 
operation (idiv instead of ditl), and 
hence also needed to set up dx prop¬ 
erly (changing sub dx.dx to cwd/nop). 
The resulting code isn't really mathe¬ 
matically kosher, because for exam¬ 
ple, the remainder of -2 / 22 is -2, 
which is less than (22 - 5). However, 
the existing code does this final com¬ 
parison unsigned, of course, so 
65533 is not less than (22 - 5), and 
the mouse click is ignored. 


Patching the DLL at Runtime 

Patching the code at runtime 
meant that I also needed to make 
sure that the original code was re¬ 
stored when I no longer needed it. 
Since a DLL's code is shared among 
whichever tasks need it, leaving the 
patch in would have caused an appli¬ 
cation which didn't use ctl3d.dll to 
exhibit similar (but opposite) drawing 
inconsistencies. Therefore, the sample 
program I've written to demonstrate 
this patching technique actually 
passes a hook function to the dialog, 
then applies the patches whenever 
the window is activated and restores 
the code when it's deactivated. As 
the final deactivation (or destroy) 
message is never received by the 
hook function, it was also necessary 
to restore the code when the dialog 
had returned. 

Performing the patching itself was 
relatively easy, although it involved 
using a number of Windows func¬ 
tions a typical application program¬ 
mer would not often use. Since you 
cannot write to a code segment 
when running in protected mode, I 
had to use the AllocSelectorO and 
PrestoChangoSelectorO functions to 
obtain a writable selector to the 
proper code segment of the common 
dialog functions. Note that I could 
also have used the semi-documented 
AllocCStoDSAliasO function to per¬ 
form this task, but it is not docu¬ 
mented (although it appears in some 
import libraries, notably Microsoft's 
Visual C++ 1.0). I also found it neces¬ 
sary to use the GetSelectorLimitO 
function, which returns the limit, or 
size, of a segment, so that I wouldn't 
GP fault when checking the bytes to 
see if the segment I was patching 
was indeed what I was looking for. I 
also used GlobalFixO to lock the 
patched segment into memory. Al¬ 
though it is extremely unlikely that 
the segment would be discarded 
while the dialog window was acti¬ 
vated, it's almost always better to be 
safe than sorry. 

One thing to be aware of when 
testing this procedure is that if the 
original code is not restored (for 
whatever reason), then the code will 
be 'locked' into the patched state. 
The code which tests to see if this is 
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Figure 2 The common dialog bug demonstration 
application 


the proper version will always fail, so the patch will never 
be performed again, and neither will the un-patching. If 
you get into such a situation, you will probably need to 
restart Windows. 

A final point: unless you check every byte in the entire 
segment, you can never be completely sure that the code 
being patched is in fact the correct version. Especially for 
the ChooseFontO validation, where only three bytes are 


checked, you may wish to enhance this (by checking the 
segment size and/or more bytes, e.g.). Note, however, that 
you can't check bytes which have been relocated (specifi¬ 
cally, bytes which contain the selector portion of far ad¬ 
dresses). This also precludes you from performing a check¬ 
sum operation on the entire segment. 

coimdfix.c (Listing 1) contains the code that demon¬ 
strates patching these two common dialog boxes on the 
fly. The code disk (see contents page for availability infor¬ 
mation) contains a demonstration program (see Figure 2) 
that lets you test out the two common dialog functions 
both with or without the patch. 

Summary 

The fact that Microsoft issues various parts of Windows 
(such as the common dialogs) as DLLs theoretically means 
that they could issue bug fixes easily without requiring us¬ 
ers to get an entire upgrade to Windows. In practice, how¬ 
ever, Microsoft has not devoted much energy to repairing 
and improving these DLLs, meaning that, just as with Win¬ 
dows itself, you are stuck with ail the bugs in the released 
versions for years at a time. Fortunately, with a little effort, 
you can correct the most annoying bugs and enjoy cor¬ 
rectly operating common dialogs without having to write 
your own from scratch. □ 
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Using Common Dialogs to 
Open Files from MS Fortran 

Kenneth G. Hamilton 


Traditional Fortran I/O is based on the concept of the 'logical unit,' the 
software equivalent of some kind of physical peripheral. Fortran code to re¬ 
quest a filename from the user might look like this: 

CHARACTER FILENAME*40 

PRINT 20 

20 FORMAT (' Enter Filename ->',$) 

READ (*,30) FILENAME 
30 FORMAT (A) 

IF (FILENAME.EQ.' ') STOP 
OPEN (UNIT=1.FILE=FILENAME_) 

This works under DOS, or in console mode under Windows or Windows NT. It 
also looks rather clunky compared to the snazzy dialog boxes sported by many 
commercial applications. This article gives you code that your Windows or Win¬ 
dows NT Fortran program can use to call GetOpenFileNameO and GetSaveFile- 
NameO, the two Windows API functions that provide the standard Windows file 
selection dialog boxes. 

What Are the Common Dialogs? 

Windows 3.1 extended the Windows API with a DLL that furnishes dialogs 
for several common tasks. In Windows 3.1, this DLL is named comdlg.dll, and 
in Windows NT it is comdlg32.dll - with a bit of conditional compilation, you 
can write code that works with both Windows and Windows NT. To use the 
common dialog functions, you fill in a structure with a variety of options, and 
call a particular DLL function that handles all the work of presenting a dialog 
box (see Figure 1) and gathering input from the user. The two common dialog 
functions I examine here are GetOpenFileNameO and GetSaveFileNameO, two simi¬ 
lar functions for obtaining one or more file names from the user. These dialogs 
provide a good deal of functionality that would be tedious to reproduce from 
scratch, such as displaying paths in a hierarchical listbox. 


Ken Hamilton has a Ph.D. in physics from the University of California, San Diego, and 
is Chief Scientist at Garjak Research, Inc. He has been involved in solid state theory, 
numerical hydrodynamics, and geophysics. Computationally, he has been hacking For¬ 
tran since the IBM 1620, and enjoys wrecking compilers during beta tests. He can be 
reached on CompuServe at 72727,777. 
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The code for this article was written for Microsoft's For¬ 
tran compilers. This should not, however, be taken as indi¬ 
cating that these facilities are only available with the Mi¬ 
crosoft products. Other Windows-capable Fortran compil¬ 
ers are available (from such companies as Watcom, Sal¬ 
ford, and Microway), and for the most part, these have the 
same DLL-calling capabilities. 

Translating C to Fortran 

Almost any language is suitable for Windows API pro¬ 
gramming, and in fact a recent user group meeting for 
customers of the Cobol vendor Micro Focus included a 


session on the use of their language, as an alternative to 
becoming ‘hardened C++ programmers.' Fortran is also a 
perfectly satisfactory API language, its principal drawback 
being the lack of documentation. To call API functions like 
GetOpenFileNameO, you have to know how to translate 
standard SDK documentation (written for C programmers) 
into the correct corresponding declarations and statements 
for FORTRAN. 

Within the SDK, the official interface declaration for Ge- 
tOpenFileNameO is: 

BOOL WINAPI GetOpenFileName (OPENFILENAME FAR*); 

To call this from Fortran, you have to 
know the Fortran equivalents for the 
types used here. The type BOOL is de¬ 
clared for C users in the header file 
windows, h as being a 16-bit integer. 
The value returned is treated as a 
logical result by the calling program, 
with zero meaning 'false' and non¬ 
zero indicating 'true.' This happens 
to be identical to the Fortran defini¬ 
tion for L0GICAL*2 variables, and so 
my sample software classifies the 
function as being of that data type. 
Since the calls to GetSaveFileNameO 
and GetOpenFileNameO are nearly 
identical, I focus on the latter except 
where the two differ. I also assume 
initially that you are using Windows 
3.1, then discuss the changes neces¬ 
sary to support Windows NT. 

As input, GetOpenFileNameO accepts 
a structure of type OPENFILENAME, 
which is passed by pushing a far 
pointer onto the stack. This is simply 
the MS Fortran default for argument 
passing, and so the next step is to 
translate OPENFILENAME, which has a C 
definition as shown in Figure 1. 

The members of the structure in 
Figure 1 tell Windows how to initially 
fill the dialog box with data, which 
disk directory to be looking at, and 
which files to display. When control 
returns from the function, informa¬ 
tion indicating the user's choice will 
be located in other members of the 
structure. 

The variable types can be con¬ 
verted as follows. The C type DUORD 
('double word') is merely INTEGER*4 to 
Fortranheads, while a variable typed 
UINT ('unsigned integer') can be re¬ 
garded as an INTEGER*2 as long as no 
arithmetic is performed on it. (The 
two variables that are declared UINT 
in the 16-bit environment, nFileOFFset 
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if I hadn’t purchased 
WinScope,” says user 
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and nFileExtension, are typed WORD under NT, and so INTE- 
GER*2 is appropriate in both cases.) The types LPSTR and 
LPCSTR are long (32-bit) pointers to strings; you can gener¬ 
ate one simply by creating a CHARACTER variable and then 
using the LOCO function to get the variable's starting ad¬ 
dress. LPARAM is another 'long* data item, i.e., an INTEGERS 
variable. 

The handle variables, HWND and HINSTANCE, are a bit trick¬ 
ier. Handles are normally INTEGER*2 under 16-bit Windows, 
but are INTEGERS under Windows NT. Knowing this, I use 
conditional compilation to make code that can run in 
either environment. The Fortran equivalent of this struc¬ 
ture is in the file opn. fd (Listing 1). 

Filling Out the Structure 

The first field of the OPENFILENAME structure is 
IStructSize, which must be filled with the byte length of 
the structure before the API function can be called. The 
allowable values are 72 (for 16-bit Windows) and 76 (for 
32-bit Windows). This field is apparently tested internally 
by Windows, since an error returns if any other value is 
inserted. 

The second and third members of the structure are 
handles; these are INTEGER*2 variables under 16-bit Win¬ 
dows, but expand to INTEGER*4 under NT. I deal with this 
by using a conditional compilation flag, UNT - if this sym¬ 
bol is defined, then the compiler will allocate four bytes 
for each of these items rather than the normal two. The 
handle to the owning window, hundOwner, can be obtained 
through a call to the API function GetFocusO, which also 
has a two-byte or four-byte return value, depending on 
the edition of Windows. The handle to the instance, hIn¬ 
stance, will not be needed and so can be set to zero. 

After the handles, the structure contains four variables 
that deal with filename filters. Your program may expect 
to be opening a file with a particular extension, as, for 
example, a plain text file with the '*.txt' extension. The 
common dialog routines can be instructed to display only 
files that have certain extensions, or to display all files (in 
other words, those that match '*.*'). The filter list is the 
mechanism for determining which files show up on the 
screen. In the lower left corner of the dialog box (Figure 
2), you can see a drop-down listbox that allows the user 
to select a file type: this is the list of filters. One of the 
members of the list is highlighted, and all of the files in 
the current directory that match that type are displayed in 
the box immediately above the list. 

When you call the API function, the variable lpstrFil- 
ter must point to a list of file types and brief descriptions, 
and this block must be packaged in a particular way. For 
each allowable type of file, the data packet must contain 
first the name of the file type (e.g., "Text Files'), then a 
NULL character, then the filter itself (e.g., '*.txt'), and then 
another NULL In Fortran, the most convenient way of com¬ 
posing the package is as a CHARACTER variable, since you 
can agglutinate the individual components using the 'dou¬ 
ble slash' concatenation operator. The NULLs are, of 
course, coded as CHAR(0). 


Figure 1 C definition of OPENFILENAME 


typedef struct tagOFN 
r 

DWORD 

IStructSize; 

HWND 

hwndOwner; 

HINSTANCE hlnstance; 

LPCSTR 

IpstrFilter; 

LPSTR 

1pstrCustomFi1 ter; 

DWORD 

nMaxCustFIlter: 

DWORD 

nFIlterlndex; 

LPSTR 

IpstrFile; 

DWORD 

nMaxFIle; 

LPSTR 

1pstrFileTitle; 

DWORD 

nMaxFIleTItle; 

LPCSTR 

lpstrlnltlalDIr; 

LPCSTR 

IpstrTItle; 

DWORD 

Flags; 

UINT 

nFi leOffset; 

UINT 

nFileExtension; 

LPCSTR 

IpstrDefExt; 

LPARAM 

lCustData; 

UINT 

(CALLBACK *lpfnHook) 


(HWND, U1NT, WPARAM, LPARAM); 

LPCSTR lpTemplateName; 

} OPENFILENAME: 

typedef OPENFILENAME FAR* LPOPENFILENAME; 


There may be several such sets of filetypes and wild¬ 
cards, with a trailing additional NULL at the end of the 
whole thing; the double NULL is the ending marker. The 
variable that needs to be passed to the API function is a 
long pointer, IpstrFilter, containing the address of the 
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Listing 1 Data type declarations for common 
dialogs 

parameter (OFN READONLY 

= #00000001) 

parameter (OFN OVERWRITEPROMPT 

= #00000002) 

parameter (OFN HIDEREADONLY 

= #00000004) 

parameter (OFN NOCHANGEDIR 

= #00000008) 

parameter (0FN_SH0WHELP 

= #00000010) 

parameter (OFN ENABLEHOOK 

= #00000020) 

parameter (OFNJNABLETEMPLATE 

= #00000040) 

parameter (OFN ENABLETEMPLATEHANDLE = #00000080) 

parameter (OFN NOVALIDATE 

= #00000100) 

parameter (OFN ALLOWMULTISELECT 

= #00000200) 

parameter (OFN EXTENSIONDIFFERENT 

= #00000400) 

parameter (OFN PATHHUSTEXIST 

= #00000800) 

parameter (OFN FILEMUSTEXIST 

= #00001000) 

parameter (OFN CREATEPROMPT 

= #00002000) 

parameter (OFN SHAREAWARE 

- #00004000) 

parameter (OFN NOREADONLYRETURN 

= #00008000) 

parameter (OFN NOTESTFILECREATE 

= #00010000) 

parameter (OFN NONETWORKBUTTON 

= #00020000) 

parameter (OFN NOLONGNAMES 
$PACK:1 

structure Is ofn / 

= #00040000) 

integer*4 IStructSize 

! Struct size 

$IF DEFINED (WNT) 

I Fortran-32 

integer*4 hwndOwner 

I Owner window 

integer*4 hlnstance 

1 Not used here 

$ELSE 

I Fortran-16 

integer*2 hwndOwner 

I Owner window 

integer*2 hlnstance 

SENDIF 

I Not used here 

integer*4 IpstrFilter 

1 Addr(filter) 

integer*4 lpstrCustomFilter 

1 Not used here 

integer*4 nMaxCustFilter 

I Not used here 

integer*4 nFilterlndex 

1 Highlighted 

integer*4 IpstrFile 

! Addrtfn bufl) 

integer*4 nMaxFile 

I Size(fn bufl) 

integer*4 IpstrFileTitle 

1 Addrtfn buf2) 

integer*4 nMaxFileTitle 

1 Sizetfn buf2) 

integer*4 lpstrlnitialDir 

I Addr(initdir) 

integer*4 IpstrTitle 

1 Addr(title) 

integer*4 Flags 

1 Mode flags 

integer*2 nFi1eOffset 

1 Offset(file) 

1nteger*2 nFileExtension 

! Offset(fext) 

integer*4 1pstrDefExt 

1 Addrtdef ext) 

integer*4 lCustDate 

1 Not used here 

integer*4 1pfnHook 

I Not used here 

integer*4 IpTemplateName 
endstructure 

1 Not used here 


Listing 2 Interface declarations for 16-bit Windows 


INTERFACE TO INTEGERM FUNCTION 
i. COMMDLGEXTENDEDERRORC) 
end 

INTERFACE TO INTEGER*2 FUNCTION GETFOCUSO 
end 

INTERFACE TO L0GICAL*2 FUNCTION 
& GETOPENFILENAHE(R) 
structure /si 
integer*4 1dummy(18) 
endstructure 
record Isl PREFERENCE] 
end 

INTERFACE TO L0GICAL*2 FUNCTION 
& GETSAVEFILENAME(R) 
structure Is/ 

1nteger*4 ldummy(18) 
endstructure 
record Isl r[REFERENCE] 
end 


CHARACTER variable. You can obtain the address by using 
the LOCO function. 

The common dialogs allow two sets of filename filters, 
essentially a 'stock' list (pointed to by IpstrFilteri plus an 
extra (or 'custom') list. There is little point in dealing with 
the complexities of the custom filter, since you can just 
put all the desired file types into the single filter list, and 
so I set both lpstrCustomFilter and nMaxCustFilter to zero 
to disable this feature. 

When the dialog first appears, one of the file types will 
already be selected, and its name will be highlighted in 
the listbox. You can determine which member of the list is 
selected by giving a value to nFi Iter Index. The value 1 in 
this variable selects the first file type in the filter string, the 
value 2 selects the second, and so on. 

The API function returns the name of the user-selected 
file in two formats. One is just the bare filename, while 
the other is fully qualified, with the disk drive letter and 
the complete directory path. To receive this information, 
you must supply a couple of text buffers and place their 
starting addresses in IpstrFile and IpstrFileTitle, again 
using the LOCO function. When the API function returns, 
the buffer pointed to by IpstrFile will contain the com¬ 
plete path and file, while that referenced by IpstrFileTitle 
will have only the plain filename itself. 

Before calling the API function, set the first byte of each 
of these buffers to NULL. Both of these strings will be re¬ 
turned as Mi-terminated ASCII, and so you can determine 
their valid lengths by using the INDEXO function to search 
for the first occurrence of CHART0). If you want to suggest a 
filename to the user, you can put that recommendation in 
the buffer pointed to by IpstrFile', it will then appear in 
the edit control box at the upper left of the dialog box. 
Remember that any such name must be terminated by a 
NULL. 

The variables nMaxFile and nMaxFileTitle must be pre- 
loaded with the size of the two buffers, measured in bytes. 
This is necessary in order to avoid overrunning a short 
buffer, with consequent clobbering of unrelated data. The 
simplest way of supplying values to these two variables is 
by applying LENO to the related CHARACTER strings - that 
way, if you change the buffer size, the information sup¬ 
plied to the function will track appropriately. 

In the center section of the dialog box, there is a direc¬ 
tory tree that shows the current directory and its relation 
to others. Programs typically allow the user to navigate 
around from that point (though this feature can be dis¬ 
abled), but one of the directories must be the current one. 
You can specify which one by giving lpstrlnitialDir the 
address of a Mi-terminated text string with the directory 
name in it. If no name is specified, then the Working Di¬ 
rectory (from the 'Properties' on the File Manager) will be 
used. 

Normally, when a program invokes GetOpenFileNameO, 
the title bar at the top of the dialog box just says 'Open' 
(with GetSaveFileNameO, the corresponding title is merely 
'Save As'). If this is satisfactory, you can set the variable 
IpstrTitle to zero and be done with it. In cases where a 
program has many different kinds of input files, and per- 
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haps several output channels as well, it is useful to have 
the dialog box announce exactly which one of these I/O 
units it is trying to connect to, by displaying a message 
like 'Select Material Properties File'. To make this happen, 
you need only create a Mi-terminated CHARACTER string, 
and then use LOCO to place its starting address in IpstrTitle. 

The common dialogs have a degree of flexibility, some 
of which can be controlled by the use of a flag word 
stored in the structure member called Flags. This is a 
status word device in which each yes/no choice is repre¬ 
sented by a single bit, and where there is a symbolic 
name for each of the bits. If you look at the top portion of 
opn.fd (Listing 1), you will see a list of flag possibilities de¬ 
fined by PARAMETER statements with hexadecimal values. All 
of the available variations can be obtained by simply add¬ 
ing (or bitwise ANDing) together combinations of these pa¬ 
rameters. 

The names of the flags bits are long enough to be al¬ 
most self-explanatory. They control such things as the ca¬ 
pability of having the 'Read Only' checkbox marked when 
the window appears (0FN_READ0NLY), of not showing the 
'Read Only* checkbox at all (OFN_HIDEREADONL f), as well as 
showing it but not allowing it to be specified (0FN_N0READ0N- 
LYRETURN). You can prevent the user from having network 
access by setting the OFNJONETVORKBUTTON bit in the flags 
word. The flag OFN_NOCHANGEDIR, if applied, prevents neo¬ 
phyte users from wandering around the directory tree and 
can thus be regarded as a security measure. 

There are times when it is neces¬ 
sary to break down a qualified file¬ 
name into its component parts for 
further handling. In order to spare 
programmers the chore of parsing, 
the API functions return a pair of 
byte offset values that make it possi¬ 
ble to determine where in the long 
string the plain filename begins, and 
where the filename extension begins. 

These values are returned in 
nFileOffset and nFileExtension, and 
both use the convention of counting 
the first character as being position 
zero. 

It is always possible for a user to 
directly type in a filename in the edit 
control field at the upper left of the 
dialog. Should the name, as received, 
have no extension then the API func¬ 
tion can add one. If you want to use 
this feature, then you must give 
IpstrDefExt the address of a text buff¬ 
er containing the default extension, 
terminated by a NULL. (Obviously, you 
can also detect this situation in your 
program, and fix it before executing 
the subsequent OPEN statement.) 

The common dialogs can also pre¬ 
sent the dialog box in a different, 
user-defined, format decribed by a 



Figure 2 GetOpenFileNameQ in action 


template. I don't do that here because it represents the 
kind of added work that I am using a common dialog to 
avoid. The structure elements KustData, lpfnHook, and 
IpTemplateName are involved with this extension, but that's 
enough said about the issue. 

Should GetOpenFileNameO return an error condition 
(.FALSE., in Fortranese), you can obtain a numerical code 
that represents the exact error status by calling the infor¬ 
mational function ComDlgExtendedErrorO. The most likely 
sources of error include closing the dialog box without se¬ 
lecting a file name or typing in an invalid name. 
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Sample Code 

The sample code here consists of a short main pro¬ 
gram that does nothing but set up a few variables and 
then call a subroutine. All of the ugly details are in the 
subroutine, plus a few INCLUDE files. If you are not inter¬ 
ested in the details of how it works, you can simply take 


Listing 3 Interface declarations for 32-bit Windows 


INTERFACE TO INTEGER‘4 FUNCTION 
& COHHOLGEXTENDEDERROR 
A [ALIAS:"_CommDlgExtendedError@0”]() 
end 

INTERFACE TO INTEGERS FUNCTION GETFOCUS 
4 [ALIAS:"_GetFocus@0"]() 
end 

INTERFACE TO LOGICAL*? FUNCTION GETOPENFILENAHE 
4 [DLLIMPORT.ALIAS:"_Get0penFileNameA@4"](R) 
structure /s/ 

1nteger*4 ldummy(19) 
endstructure 
record /s/ PREFERENCE] 
end 

INTERFACE TO L0GICAL*2 FUNCTION GETSAVEFILENAME 
4 [DLLIMPORT.ALIAS:"JetSaveFi 1 eNameA@4"](R) 
structure /s/ 
integer*4 ldummy(19) 
endstructure 
record /s/ r[REFERENCE] 
end 


Listing 4 The main program 


PROGRAM OPTST 
parameter (MAXFILTER=10) 
character*60 msg. dir. pathfile 
structure /s_f11t/ 
character*20 desc. mask 
endstructure 

record /s_f11t/ filt(MAXFILTER) 
logical readonly 
c 

msg = 'Please Supply the Input File Name' 
dir = ' ' 
nfilt = 3 

filt(l).desc = 'Fortran source' 
filt(l).mask = '*.for' 
filt(2).desc = 'Object modules' 
filt(2).mask = '*.obj' 
filt(3).desc = 'All files' 
filt(3).mask = '*.*' 
c 

call getinpfilename(msg, dir, nfilt, filt, 

4 pathfile, readonly) 
print 50, pathfile, readonly 
50 format (' Subroutine returned the name: ',A/ 
4 ' Readonly = ',L5) 
c 

msg = 'Please Supply the Output File Name' 
call getoutfilenametmsg, dir, nfilt, filt, 

4 pathfile, readonly) 
print 50, pathfile, readonly 
c 

stop 

end 


the subroutine and use it as-is in your own Fortran pro¬ 
grams. 

The software that accompanies this article consists of 
the following files: 

• opn. fd (Listing 1), data type declarations. 

• opn.fi (Listing 2), interface declarations for 16-bit Win¬ 
dows. 

• opn3. fi (Listing 3), interface declarations for 32-bit Win¬ 
dows. 

• optst. for (Listing 4), the main program. 

• getfn.for (Listing 5), a sample subroutine that sets up 
the structure, calls GetOpenFileNameO or GetSaveFile- 
NameO, and then reports any error condition by calling 
ComDlgExtendedErrori). 

• optst. def (Listing 6), the module definition file for 16-bit 
Windows. 

• makefile.msO (Listing 7), for MS Fortran v5.1. 

Strictly speaking, the interface declarations in opn.fi 
(Listing 2) are not necessary, as the calling protocols for 
GetOpenFileNameO, GetSaveFileNameO, GetFocusO, and 
CommDIgExtendedErrorO are all identical with the Fortran de¬ 
fault, ie., the function names are converted to all caps, 
and the arguments are passed by reference. (So why does 
Microsoft keep using C for this stuff, anyway?) 

The declarations in opn3.fi (Listing 3), on the other 
hand, are definitely needed as they make use of the ALIAS 
keyword to force a mixed upper/lower spelling of the ex¬ 
ternal names. (The compiler will otherwise attempt to con¬ 
vert all external symbols to uppercase.) In addition, Win¬ 
dows NT includes two versions of the dialog box routines, 
one for ASCII characters and the other for Unicode. (These 
have slightly different entry point names, distinguished by 
a suffix letter.) Lacking any Chinese or Arabic characters in 
the file names, I chose the former. 

You can see a full translation of the OPENFILENAME struc¬ 
ture in opn.fd (Listing 1), where it appears as the structure 
type S_0FN. I have used the symbol UNT to activate the con¬ 
ditional compilation switch: this should be defined only 
when generating Windows NT code. Along with the defini¬ 
tion of the structure, opn.fd includes definitions for the 
flags that can be passed through to GetOpenFileNameO and 
its sister function, GetSaveFileNameO. These values are the 
same as those defined in one of the SDK header files for 
C users. 

The sample main program is optst. for (Listing 4). 
There, the boxtop title (MSG) is defined, the initial directory 
is set to blank (so that the File Manager's working direc¬ 
tory will be used), and some information is given to define 
three filename filters. (I have set the filter system to dis¬ 
play either *.F0R files, or *.0BJ files, or all files, so that you 
can run the program against its own default directory and 
see things on the screen.) This information is then passed 
to a subroutine that invokes the API function to open an 
input file. After control returns, the program changes the 
boxtop message, and makes a second call to get the 
name of an output file. 

getfn.for (Listing 5) is the black box subroutine that 
calls either GetOpenFileNameO (for input files) or GetSaveFile¬ 
NameO (for output files). Depending upon the flag UNT, the 
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compiler will include either opn. fi or opn3. fi to declare API 
interfaces, along with opn. fd to define the data structure 
and the symbolic flag bits. As I described earlier, the data 
return type of the API function GetFocusO is different be¬ 
tween 16- and 32-bit environments, and so this is also 
dealt with by the WNT flag. 

makefile.ms0 (Listing 7) shows a makefile for 16-bit Win¬ 
dows; it references optst.c/ef (Listing 6). The primary thing 
that you should notice in the .def file is the presence of 
the three IMPORTS directives at the end: these are needed 
in order to connect to the dynamic link library. No make¬ 
file is listed for 32-bit Windows, as the entire program can 
be built using the single command: 

fl32 /MW /DWNT optst.for getfn.for 

Please note the presence of the /DWNT 
flag - this activates the change from 
the 16-bit compilation model to the 
NT form, through the conditional 
compilation directives. No module 
definition file is needed, as Powersta- 
tion Fortran for Windows NT allows 
the attribute DLLIMPORT to be ap¬ 
plied to the interface declaration for 
an external routine, and I have used 
this capability in opn3. fi. 

How the Subroutine Works 

The interface subroutine GET- 
INPFILENAME has a second entry point, 

GETOUTFILENAME, so that one source 
module can provide access to both 
GetOpenFileNameO and GetSaveFile- 
NameO. The processes of setting up 
and calling the two API functions are 
almost identical, so a doubleheaded 
procedure is a compact way of han¬ 
dling the situation. A local logical 
variable, INPUT, is set upon entry, and 
later used to pick the correct execu¬ 
tion path when things diverge. 

The filter information is passed to 
the subroutine in the form of an ar¬ 
ray of structures (FILT), which is ac¬ 
companied by a parameter (NFILT) 
that indicates how many individual 
filters are being passed. A 00-loop 
moves the contents of this array into 
the packed filter buffer, szFilter. 

The other CHARACTER variables are 
moved to local storage, and termi¬ 
nated by NULLs ; this step avoids pass¬ 
ing the zero bytes back to the calling 
routine, as would be required if the 
formal parameter names were used. 

Following that, the members of the 
structure OFN are defined. 


In C programs, the size of the structure is often ob¬ 
tained from the sizeofO operator. Microsoft did not in¬ 
clude this intrinsic in its Fortran compiler, although some 
other vendors (such as Watcom) have it. In getfn.for, I 
compute the size by taking the difference between the ad¬ 
dresses of the first and last members of the structure, and 
then adding 4, the size of the last element. 

The handle to the current focus is defined through an 
API call. The other elements of the structure are filled by 
supplying either constants, addresses (via LOCO), or buffer 
lengths (using LENT)), as explained earlier. 
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Listing 5 Sample subroutine to call common dialogs 

JIF DEFINED (WIT) 

Include 'opn3.fi' 

(ELSE 

Include 'opn.fi' 

SENOIF 

SUBROUTINE GETINPFILENAMEtMSG, DIR, NFIIT, FILT, 

X PATHFILE. READONLY) 

character*!*) msg. dir. pathfile ! Formal params 
structure /s_f11t/ 1 Formal param 

character*20 desc, mask 
endstructure 

record /s_filt/ filt(nfllt) ! Filter list 

logical readonly 1 Checkbox stat 

Include 'opn.fd' ! Defines s_ofn 

record /s_ofn / ofn 1 Arg for Digs 

character*256 szDIrName. szFIle, szFileTItle 
character*256 szTItle, szF11ter*512 
automatic 
tIF DEFINED (WIT) 

1nteger*4 GetFocus 

tELSE 

1nteger*2 GetFocus 

SENOIF 

integer*4 ComrClgExtendedError, 1 status 
log1cal*2 GetOpenFIleName, GetSaveFileName, ok 
log1cal*2 Input 

Input = .TRUE. ! Input file 

go to 10 
c 

ENTRY GETOUTFILENAMEIMSG, DIR, NFILT. FILT. 

& PATHFILE, READONLY) 

Input = .FALSE. ! Output file 

c 

c File-Opening Common Dialog Example Subroutine 

c Kenneth G. Hamilton - Windows/DOS Dev Journal 
c Compose the filter string: 

c 

18 szFilter « ' ' 1 Init to blank 

Ip = 1 ! Char position 

do 1 = 1. nfilt 1 Loop over all 

nc = len_trim(f11t(1).desc) 1 Description 

szF11ter(1p:ip*nc) = f11t(1).desc(:nc)//char(8) 

Ip * ip + nc + 1 1 Inc position 

nc = Ien_tr1m(f11t(1 ) .mask) ! Filter proper 

szF11ter(1p:1p*nc) ■ filt(1).mask(:nc)//char(8) 
ip = Ip + nc + 1 1 Inc position 

6nddo 

szFIlterdprlp) = char(0> 1 Second NULL 

c 

szFile(lrl) * char(0) ! d:\path\f11e 

szF11eT1tle(l:l) = char(0) ! file name 

nch « Ien_tr1m(d1r) 1 Count chrs 

szDIrName * dir 1 Copy Init dir 

szDirName(nch+l:nch+l) = char(0) ! plus a NULL 
nch * lentrim(nsg) ! Count chrs 

szTItle * msg 1 Boxtop title 

szT1tle(nch+l:nch+l) = char(0) ! plus a NULL 
c 

c Fill the OPENFILENAME structure for Input 
c 

ofn.lStructSize = loc(ofn.lpTemplateName) - 
& Toc(ofn.TStructSIze ) + 4 ! Struct Size 

ofn.hwndftmer = GetFocus! ) ! Popup over 

ofn.hlnstance = 0 ! Don't need 

ofn.lpstrFIlter » loc(szFilter) 1 Addr(filter) 

ofn.IpstrCustomFIIter = 0 ! Don't need 

ofn.nMaxCustFIlter = 0 ! Don’t need 

ofn.nFIlterlndex =1 1 1st filter 

ofn.lpstrFIle * loc(szFlle) 1 Addr(pth\f11) 

ofn.nMaxFile * len(szfile) ! Size(buffer) 

ofn.lpstrFileTItle * loc(szFlleTltle) 1 Adr(fll) 

ofn.nMaxFI1eTItle = len(szFlleTltle) ! Slz(buf) 

ofn.lpstrlnltlalDir = loc(szDirName) ! Adr(dlr) 

ofn.lpstrTitle ■ loc(szTltle) 1 Adr(top) 

ofn.lpstrDefExt =0 1 Not using 

ofn.lCustOate = 0 ! Zero out 

ofn.lpfnHook =0 ! to prevent 
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Listing 5 continued 

ofn.1pTemplateName = 0 

! activating 

pathfile « szFile(:nch) 1 Get qualname 

c 


readonly = 1and(ofn.Flags,OFN_READONLY).ne.0 

If (Input) then 


else ! No good 

ofn.Flags = OFN PATHMUSTEXIST + OFN FILEMUSTEXIST 

1 status « CoouClgExtendedErrorO 

ok * GetOpenFI1eName(ofn) 

1 Call dialog 

print 90. 1 status 1 Show error 

else 


90 format C Error status \Z8,'(hex) occurred') 

ofn.Flags = OFN_PATHMUSTEXIST 


pathfile • ' 
readonly * .FALSE. 

A + OFN 0VERWRITEPR0MPT + OFN HIDEREADONLY 

ok • GetSaveFI 1 eName(ofn) 

! Call dialog 

end If 



c 

If (ok) then 

! It worked 

return 

end 

nch * 1ndex(szF11e.char(0)) - 

1 1 Length 


In setting up the structure member 
Flags, I decided to make the two API 
calls slightly different. If the user is 
asking for an input file, then the flag 
bits 0FN_PA THHUSTEXIST and OFNJILE- 
MUSTEXIST are set, which means the 
dialog box will not return the name 
of a file that isn't there. If a bad file¬ 
name is typed in, a message box ap¬ 
pears over the dialog box, announc¬ 
ing that the choice is no good. The 
only way of closing the dialog box 
with an invalid filename is to click on 
'Close', which will cause an error 
status to be returned by GetOpenFile- 
NameO, putting a . FALSE, value in the 
variable OK. 

If the interface subroutine was 
called through the entry point that 
asks for output filenames, then Get- 
SaveFileNameO will be invoked in¬ 
stead. The Flags word will be set so 
that, if the user supplies the name of 
an existing file, a message box will 
appear questioning the choice. The 
user must then acknowledge the in¬ 
tent to overwrite that file. This is the 
purpose of the 0FN_0VERURITEPR0MPT 
flag bit set in getfn.for (Listing 5). 
Also, for an output file request, I 
have added the OFNJIDEREADONLY bit, 
as it makes no sense to encourage a 
user to disallow writing to such a 
channel. In addition, the dialog re¬ 
quires that the target directory al¬ 
ready exist. 

Assuming that the dialog call was 
carried out successfully, the status 
variable OK will have a value of 
.TRUE., and the fully-qualified file¬ 
name will be copied into the subrou¬ 
tine argument PATHFILE. The trailing 
NULL will be left off, so that the calling 
program will receive a conventional- 
looking Fortran CHARACTER value, padded 
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Listing 6 Module definition file for 16-bit Windows 


NAME 

OPTST WINDOWAPI 

EXETYPE 

WINDOWS 3.1 

STUB 

'WINSTUB.EXE' 

PROTMODE 


CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE 

HEAPSIZE 

1024 

STACKSIZE 

8096 

IMPORTS 

COMMDLG.GETOPENFILENAME 

IMPORTS 

COMMDLG.GETSAVEFILENAME 

IMPORTS 

COMMDLG.COMMDLGEXTENDEDERROR 


Listing 7 Makefile for MS Fortran v5.1 


optst.exe: optst.obj getfn.obj optst.def 
link @«optst.lrf 
optst.obj+getfn.obj. 

optst, optst, /NOD:11ibfor7 llibfew.lib. optst.def: 

« 

optst.obj: optst.for 

fl /c /MW optst.for 

getfn.obj: getfn.for opn.fi opn.fd 
fl /c /MW getfn.for 
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with trailing blanks. The input dialog 
includes a checkbox for indicating 
that the file should be "Read Only', 
and the status of that control is cop¬ 
ied to the formal parameter READONLY, 
for return to the calling program. 

If the return status was bad, then 
the the subroutine will call ComDlgEx- 
tendedErrorO, yielding a return value 
that is the error code. Since the Flags 
word required paths and input files to 
exist, the most likely possibility of fail¬ 
ure is that the user closed the box 
without selecting a file properly, which 
gives a return status of zero. It is also 
possible to have a dialog failure if one 
of the local buffers is too short to ac¬ 
cept the filename, but I have made the 
sizes large enough that this should not 
be a problem (unless you have the 
world's biggest directory tree!). 

Summary 

So there you have it: an example 
of calling two types of common dia¬ 
logs, packaged up as a subroutine 
that you can use as a black box. To 
use, all you have to do is compose 
the argument list, as I did in optst. for 
(Listing 4), and call one or both of 
the entry points. When writing the 
software, I decided to pass the filter 
information in the form of an array 
of structures (rather than as two ar¬ 
rays). The rationale for this choice 
was to emphasize that for every de¬ 
scription there must be a filter, and 
vice versa. Obviously, if you are 
modifying the code, you can switch 
this to the other form quite easily. 
Should you want to call the API func¬ 
tions directly from your program, 
then getfn. for (Listing 5) should give 
you the information that you need to 
copy, and you can probably use the 
INCLUDE files just as they are. □ 
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Microsoft Bug++ of the Month 

Mark Nelson 


From time to time, someone in the computing business 
will stand up before an audience and recite a little speech 
bragging about our progress over the past forty years. 
Typically, this speech compares our business to the auto 
industry, saying that if automobiles had tracked the pro¬ 
gress of computers since the 1950s, the average car 
would get a zillion miles per gallon, cost a nickel, etc. The 
Unix Hater's Handbook (Garfinkel, Weise, and Strassman - 
San Mateo, CA: IDG Books, 1994) gives a humorous, and 
probably more accurate, version of this quote: 

If the automobile had followed the same development as 
the computer, a Rolls Royce would today cost $100, get a 
million miles per gallon, and explode once a year, killing 
everyone inside. 

The only quibble I have with this quote is that I think the 
once per year frequency is significantly optimistic. Once a 
week might be closer to the truth. 

Just as we expect auto makers to protect us against 
some of our own blunders, we expect C++ compilers to 
protect us from certain kinds of coding idiocy. Unfortu¬ 
nately, this isn't always the case. Loyal reader Michael Kel¬ 
son, from Iterated Systems, wrote to complain about an 


oversight in the Visual C++ 1.5 compiler. Visual C++ hap¬ 
pily compiles code that looks like this, not even emitting a 
warning: 

int &foo() 

{ 

int a = 1; 
return a; 

} 

This code clearly has a problem, in that it is returning a 
reference to an automatic variable. After the function ex¬ 
its, a is just an ephemeral location on the stack that can 
be destroyed at any moment. This is clearly an error in 
design, although it may be syntactically legal C++ code. 

After experimenting with this some more, I came up 
with the code in bug009e.cpp (Listing 1). This code also 
shows that Visual C++ will cleanly compile code that re¬ 
turns a reference to a temporary object, which is an error 
as well. If bug009e.cpp ran the way an inexperienced pro¬ 
grammer intended, it should produce a line of output that 
looks like this: 

(continued on page 52) 


Mark Nelson is a programmer for Greenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M8T Books. You can reach Mark 
on CompuServe at 73650,312. 
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1=5 j=10 k=20 

Instead, on my machine it produces this output: 

1=716 j=716 k=20 

All of the other compilers that I have access to flag this 
either as an error or a warning. Borland treats it as an 
error, refusing to compile the code, producing the follow¬ 
ing lines of diagnostic output: 

Borland C++ Version 4.02 Copyright (c) 

1994 Borland International 
bug009e.cpp: 

Error bug009e.cpp 27: Reference initialized 
with 'int’. needs lvalue of type ’int’ 
in function foolO 

Error bug009e.cpp 33: Attempting to return 
a reference to local variable 'a’ in 
function foo2() 

Warning bug009e.cpp 34: ’a’ is assigned a value 
that is never used in function foo2() 

*** 2 errors in Compile *** 

Visual C++ doesn't generate any diagnostics for this 
code, even at the maximum warning level. 

Steve Ross of Microsoft provided the vendor review 
for this bug. He points out that this should be a warning 
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(just a diagnostic message) and not an error (refusal to 
compile), which is probably a fair assessment unless the 
ANSI C++ committee eventually deems otherwise for con¬ 
structs like this. He goes on to say: 

It is though, in all likelihood, a user error/oversight. Thus, 
as you maintain, it warrants a warning along the lines of 
'attempt to return a temporary from function.' We should 
make sure that the compiler issues such a warning in the 
future. 

My thanks (and a fab W/DDJ t-shirt) go to Michael Kel¬ 
son for reporting on this problem. Remember, if you run 
across some compiler behavior that rubs you the wrong 
way, we would like to hear about it. Send your submis¬ 
sions to wdletter@rdpub. com. □ 


Listing 1 bug009e.cpp — Automatic 
variable/temporary object problem in Microsoft Visual 
C++ vl.5 


/* 

* BUG009E. CPP 

* 

* This program demonstrates a couple of simple C++ programming errors. 

* In foolO, the programmer has attempted to return a reference to a 

* temporary object. The temporary’s lifetime expires upon the exit 

* from the function, so this is clearly erroneous. Likewise, in foo2() 

* the programmer has attempted to return a reference to an automatic 

* object, which is also only viable inside foo2(). 

* 

* This error is not flagged by Microsoft's Visual C++ compiler, even 

* using /W4. which is supposed to be the maximum warning setting. 

* Borland, Symantec, and Katcom all correctly flag this as an error or 

* warning. 

* 

* This program should produce erroneous output, perhaps looking like 

* this: 

* 

* 1=716 j=716 k=20 

* 

*/ 

♦include <stdio.h> 

const int JfoolO 
( 

return 5; 

) 

const int 4foo2() 

{ 

int a = 10: 
return a; 

} 

int foo3() 

{ 

return 20: 

) 

main!) 

( 

const int 4i = foolO; 

const int 4j = foo2(): 

const int k = foo3t): 

printft "i=*d j=*d k=*d\n". 1, j. k ): 

return 1: 

) 

// End of File 
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Borland Bug++ of the Month 

Mark Nelson 


Fairly soon after the release of Borland C++ 4.0, Bor¬ 
land issued a special patch upgrade that added a few new 
features and, reportedly, repaired a significant number of 
bugs. Nobody likes to admit it, but sooner or later every 
programmer has to issue a minor upgrade for the express 
purpose of fixing mistakes. 

Regardless of Borland's motivation for releasing C++ 
4.02, the upgrade took a small step backwards in one re¬ 
spect. The first hint that there might be a problem came 
just a few days after the release of the upgrade. Our cus¬ 
tomers at Greenleaf Software began calling in and telling 
us that our BUILD utility was no longer working properly. 

The BUILD utility is a simple program used to rebuild 
object libraries from source. It sets up various compiler op¬ 
tions, then spawns the compiler, assembler, or librarian as 
need be, using the runtime library spawnO family of func¬ 
tions. 

The problem was that our BUILD utility had suddenly 
begun to report that our command lines were too long for 
spawn 0 to be able to execute. What was puzzling was that 


the command lines in question were only 100 or so char¬ 
acters long, well short of the 128-byte maximum imposed 
by MS-DOS. Even so, spawnO was reporting an E2BIG error, 
meaning the argument list was too long. 

Fortunately, Borland shipped the full runtime library 
source with the 4.02 upgrade, so I was able to track the 
problem down quickly. Deep in the heart of the library, 
Borland had inadvertently added a comparison of the 
spawnO and execO command lines against _MAXPATH. _MAX- 
PATH under MS-DOS is 80 characters. The correct compari¬ 
son would have been against a 128-byte constant. 

bug009a.cpp (Listing 1) illustrates this bug clearly enough. 
The program makes a call to spawn! () with a command 
line length just a bit over 80 characters. When compiled 
with Borland 4.0 or some other compiler, the output from 
this program looks something like this: 

123456789 123456789 123456789 123456789 123456789 ... 
result = 0. errno = 0 


Mark Nelson is a programmer for Greenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M9T Books. You can reach Mark 
on CompuServe at 73650,3!2. 
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Listing 1 bug009a.cpp — Command-line length bug in Borland C++ v4.02 

/* 

♦include <errno.h> 

* This program illustrates a bug in Borland's 4.02 Run Time Library. 

* DOS has a limit of 128 lines in a command line, but Borland has 

int maint) 

* inadvertently shortened that limit to 80 characters. This program 

( 

* performs a simple spawnlO function call, whose output should look 

int result: 

* something like this: 

result * spawnK P_WAIT, 

* 

"c:\\command.com”. 

* 123456789 123456789 123456789 123456789 123456789 ... 

"command”, 

* result » 0, errno * 0 

7c". 

* 

"echo". 

* With Borland 4.02, the program instead produces the following output: 

"123456789 123456789 " 

* 

"123456789 123456789 " 

* result * -1, errno * 20 

"123456789 123456789 " 

•k 

"123456789 123456789", 

*/ 

NULL ); 

♦include <$tdio.h> 

printfi "result = Sid, errno = %d\n", result, errno ): 
return 1; 

♦include <stdlib.h> 

) 

♦include <process.h> 

// End of File 


Under Borland C++ 4.02, the same program produces this 
output: 

result = -1, errno = 20 

This indicates that spdwnlO is not working properly. 

The good news is that Borland has noted in its Com¬ 
puServe forum that this problem will be fixed in an up¬ 
coming patch. The bad news is that there is no easy 
workaround to the problem. If you absolutely can't trim 


your command line under 80 characters, your only alter¬ 
native at this time is to pass the command line directly to 
MS-DOS using an int86x() function call. It's either that, or 
wait for the patch! 

According to Don Dornblaser of Borland, who provided 
the vendor review for this bug, 'the bug has been fixed 
and is not reproducible in the current build of Borland C++ 
v4.5." That version is not shipping as of this writing, but 
should be available by the time you read this column. □ 
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■ Proposals due 4 Feb 1995 
manuscripts due 15 Mar 1995 
Suggested topics: How to take ad¬ 
vantage of Daytona’s new debugging 
API. A base C++ class for catching 
constructor/destructor bugs. Tips on 
which debugging tool to use for 
which problems. A test jig for debug¬ 
ging VxDs that expose APIs. A pro¬ 
gram that detects incorrectly installed 
OLE servers. 


■ Proposals due 3 Mar 1995 
manuscripts due 14 Apr 1995 

Suggested topics: How to port your 
DLL to Windows 95. Tips for faster 
graphics under Windows 95. How to 
take advantage of the Windows 95 
printing architecture. Top ten ways 
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Capturing Hot Keys in Windows 


Robert Mashlan 



Borland C++ v4.x 



Robert Mashlan is an independent software consultant doing business as R2M Soft¬ 
ware Company. He is currently doing development work for Radish Communications 
Systems, Inc. of Boulder, CO. He may be reached at (503) 738-0849 or rmash- 
Ian@r2m.com on the internet. His POP public key fingerprint is 77 F9 F3 35 E8 3C FE 
7A 87 CB 19 FB EC 73 77 94. 


Capturing a hot key in Windows gives your application a user interface that 
allows quick access to a program, or part of a program's functionality, with a 
few keystrokes. Hot keys are widely used by DOS TSRs to bring the TSR into 
the foreground when another application is running. Windows applications can 
take advantage of the same technique, defining hot keys that bring their win¬ 
dow to the top or perform other functions. 

One special problem in creating hot keys for Windows applications is mak¬ 
ing the hot key perform correctly even if the current application is a full-screen 
DOS box. This requires the support, directly or indirectly, of the virtual key¬ 
board device (VKD), which is responsible for making both Windows and DOS 
boxes believe they have complete access to the keyboard. 

There are three ways to implement hot keys in Windows. First, you can use 
a pair of undocumented Windows messages to define hot keys. This technique 
works correctly with both Windows applications and DOS boxes, but it is incon¬ 
venient to use if you want to define more than one hot key, and an uncoop¬ 
erative or poorly coded application can prevent the hot key from activating 
your application. Second, you can use the Windows hook functions to intercept 
keyboard input. This works with Windows applications, but not with DOS 
boxes, and can also be vulnerable to buggy or uncooperative applications. 
Third, you can use a VxD to access the services of the VKD directly, which 
enables you to define hot keys that work in DOS boxes. Combining the second 
and third techniques gives you hot keys that work with both DOS and Win¬ 
dows applications, without the limitations of the first technique. This article de¬ 
scribes and supplies complete code for implementing ail three techniques; it 
also discusses problems that other applications can cause for hot keys and 
ways to work around them. 


(text continued on page 59) 
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RPC for NT 


fey Guy Eddon 

RPC for NT shows you how to write a 
distributed application using the Remote 
Procedure Call model, a powerful 
technology that allows server and clients to 
share not just data files but CPU cycles. 

Using Microsoft’s RPC implementation, an 
NT server and clients running MS-DOS, 
Windows 3.1, Windows for Workgroups, or 
Windows NT can work together to solve a 
complex problem in a fraction of the time it 
would have taken a single machine. 


Use code T58C when ordering 
RPC for NT with disk included 


plus shipping 


913-841-1631 
FAX 913-841-2624 


VISA 
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Order your copy today! 


Build Remote Procedure Calls 
from basic to sophisticated 

Guy Eddon guides you from a simple "Hello 
World" RPC application through a series of 
increasingly demanding programs that 
encompass all aspects of remote procedure calls. 
You’ll learn about: 


■ Implicit and explicit binding procedures 

■ Structured exception handling 

■ Multithreaded servers 

■ The RPC name service 






















































Table 1 Modifier key states 


Value 

Meaning 

0x01 

Shift key is pressed 

0x02 

Control key is pressed 

0x04 

Alt key is pressed 


(text continued from page 55) 


Table 2 

WM_SETHOTKEY results 

Value 

Meaning 

-i 

Invalid hot key value 

0 

Invalid hwnd 

i 

Success 

2 

Success, but another application already owns the 
hot key. 


WM_SETHOTKEY and 
WM_GETHOTKEY 

Windows 3.0 and 3.1 added sup¬ 
port for two undocumented hot key 
messages, UM_SETHOTKEY and 
UM_GETHOTKEY. These messages are, 
however, documented for the Win32 
API. An application sends UM_SETH0T- 
KEY to assign a hot key to a top-level 
window. When the hot key combina¬ 
tion is pressed by the user, Windows 
sends a UM_SYSCOMMAND message to the 
currently active window (not the as¬ 
signed window) with wParam set to 
SC_H0TKEY and the low word of IParam 
set to the handle of the window to 
which the hot key is assigned. A nor¬ 
mal window procedure will pass this 
message on to DefUindowProcO, which 
will respond by activating and restor¬ 
ing (if necessary) the associated win¬ 
dow. You can send UM_GETH0TKEY to a 
top-level window to retrieve the hot 
key associated with that window. 

The UM_SETHOTKEY message is used 
by the Windows Program Manager, 
which refers to hot keys as "Shortcut 
Keys." The message is also used by 
WINOLDAP (the Windows application 
which provides an environment for 
DOS programs to run in 386 En¬ 
hanced Mode) for setting the "Appli¬ 
cation shortcut key" specified in a 
DOS application's PIF file. 

The UM_SETH0TKEY and MM_GETHOTKEY 
messages use the same format to de¬ 
scribe a hot key: it is a 16-bit value 
with the virtual key code of the hot 
key in the low byte, and the modifier 
key state (see Table 1) in the high 
byte. All hot keys should use the Alt 
key modifier, since a hot key is a 
type of system key and should not 
be directly accessible by applications. 

The UM_SETHOTKEY message takes 
the hot key in wParam and 0 in IParam 



for C/C++ 

presents Bug # 553 


#define VERISON 20 
#include <stdio.h> 

char *ss( char *s) { return s; } 

int main() 

{ 

#if VERSION > 10 

printf( "hello %s\n", ss("world") ); 

#endif 

return 0; 

} 


The programmer was puzzled as to why he received no output. What did he do 
wrong? Call if you need a hint. Refer to Bug #553. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender) and OS/2. PC-lint for C is 
still available for only $139. 

FlexeLint for C/C + + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
NT, mainframes, etc. Distributed in 
shrouded C source form. Call for pricing. 


©imp®! S®fiwiir<§ 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 


PA add 6% sales tax. 


30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


O Request Fax #1082 □ 
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Listing 1 hotkey.c — Using WM_SETHOTKEY 


/* listing 1 - hotkey.c Demonstrates the use of WM SETHOTKEY 

} 

copyright 1994 Robert Mashlan 

return DefWindowProcIhwnd,msg,wParam,IParam); 

*/ 

Mefine STRICT 

} 

#incTude <windows.h> 

int MessagePump(void) 

#i nclude <string.h> 

{ 

MSG msg; 

// these aren’t defined in 16-bit windows.h 

while! GetMessaget&msg,NULL.0,0) ) { 

#define WM SETHOTKEY 0x0032 

TranslateMessage(Smsg); 

#define WM_GETHOTKEY 0x0033 

DispatchMessage(&msg); 

} 

return msg.wParam; 

// defines for upper byte of hot key descriptor 

#define SHIFT 0x0100 
#define CTRL 0x0200 

} 

#define ALT 0x0400 

YApragma argsused 

int PASCAL WinMain! HINSTANCE hlnst, HINSTANCE hPrevInst, 

// hotkey we assign to our app 

LPSTR IpstrCmdLine, int nCmdShow ) 

Y/define HOTKEY (CTRL+ALT+’H’) 

{ 

char szClassNamef] = "WM SETHOTKEY Test"; 

LRESULT CALLBACK export MainWndProct HWND hwnd. UINT msg, 

WPARAM wParam, LPARAH IParam ) 

HWND hwnd; 

{ 

if (! hPrevInst) { 

switch(msg) { 

WNDCLASS wc; 

case WM CREATE: { 

memset(&wc,0,sizeof(wc )) ; 

char *msg » NULL; 

wc.hbrBackground = (HBRUSH)(COLOR WINDOW+1); 

switch! SendMessage ( hwnd.WM_SETHOTKEY.HOTKEY 0 ) ){ 

wc.hCursor = LoadCursortNULL.IDC ARROW); 

case 2: 

wc.hlcon = LoadlconCNULL,IDI APPLICATION); 

msg = "hot key is used by another app"; 

wc.lpfnWndProc = MainWndProc; 

break; 

wc.lpszClassName = szClassName; 

case 0: 

wc.hlnstance - hlnst; 

msg = "WM SETHOTKEY failed, invalid HWND"; 

RegisterClass(&wc); 

break; 

} 

case -1: 

hwnd = CreateWindowtszClassName,szClassName, 

msg = "WM SETHOTKEY failed," 

WS OVERLAPPEDWINDOW, 

" invalid hot key"; 

CW USEDEFAULT,CW USEDEFAULT,250,250, 

break; 

NULL,NULL,hlnst,NULL); 

} 

if(hwnd) { 

if(msg) 

ShowWindow(hwnd,nCmdShow); 

MessageBoxthwnd,msg,”WM_SETHOTKEY",MB_OK); 

UpdateWindow(hwnd); 

return 0; 

} 

return MessagePumpO; 

} 

return -1; 

case WM_DESTROY: 

PostQuitMessage(0); 

} 

return 0; 

/* End of File */ 


Listing 2 hotkeyhk.c — A DLL for complete keyboard hooking 

/* listing 2 - hotkeyhk.c 

// hotkey notification. 

DLL Module for hooking hot keys within Windows 

FARPROC lpfnVHKD; // api entry point for VHKD.386 

copyright 1994 Robert Mashlan 


*/ 

Mefine VHKDID 0x331b // VxD id for VHKD 

YAdefine STRICT 

WORD nHotKeys; // number of hot keys in list 

YAinclude <windows.h> 

LPHOTKEYSTRUCT IpHK; // list of hot keys 

#include Calloc.h> 


#include "hotkeyhk.h" 

// a handy macro to get what we need from keyboard 


// message IParam 

// structure used to track each hot key 

Me fine KeyDownd Param) ((lParamS(lL«31))?FALSE:TRUE) 

typedef struct { 


WORD wHotKey; // hot key descriptor - virtual key code 

LRESULT CALLBACK export HotKeyHook! int nCode, 

// in the low byte ORed and modifier 

WPARAM wKey. LPARAM IParam ) 

// key flags in the high byte. 

// Hook procedure - called when a windows application 

HWND hwnd; // window which gets notification 

// is about to retrieve a WM KEYDOWN, WM KEYUP 

LPARAM IParam; // data passed back in IParam 

// WM SYSKEYDOWN. WM SYSKEYUP message. 

DWORD hHotKey; // handle returned from 

( 

// SetVirtualHotkey!); 

static WORD ModKeys; // has bits set for ALT/SHIFT/CTRL 

) HOTKEYSTRUCT, FAR ‘LPHOTKEYSTRUCT; 



if ( nCode >= 0 4& nCode != HCJOREMOVE ) { 

HINSTANCE hlnst; // hlnstance of this module 

int i; 

HHOOK hKeyHook; // handle for keyboard hook 

// update ModKeys if needed 

HHOOK hShellHook; // handle for shell hook 

if ( wKey == VK_SH IFT ) { 

UINT wm_hotkeypressed; // registered windows message for 

if ( KeyDownd Param) ) 
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and returns one of four possible results (see Table 2). Note 
that if the hot key is set, but another window owns the 
hot key, the hot key will not work until the other window 
is destroyed. 

To set a hot key for a window, use code like this: 

^define SHIFT 0x0100 
#define CTRL 0x0200 
#define ALT 0x0400 


LRESULT Status; 

WPARAM Key = V I ALT I CTRL; 

Status = SendMessage(hWnd, WM_SETHOTKEY, Key, 0); 

S' 

If you want to remove a hot key assignment from a win¬ 
dow, use the same function call, but pass a 0 instead of a 
hot key code as the third argument to SendMessageO. 


Listing 2 continued 


Hod Keys I = SHIFTJIT; 
else 

ModKeys 4= -SHIFTJIT; 

} else if( wKey = VKJ0NTR01 ) { 
if( KeyDownI1Param) ) 

ModKeys |= CONTROLJIT; 
else 

ModKeys 4= -CONTROLJIT; 

} else if( wKey == VK.MENU ) { 
if( KeyDownC1Param) ) 

ModKeys |= ALTJIT; 
else 

ModKeys 4= -ALTJIT; 

} else { 

// search through list 
for(i=8;i<nHotKeys;i++) { 

if( 1pHK[i].wHotKey *» wKey+ModKeys ) { 

// found a match 
if( KeyOown(lParam) ) { 

// if this key is a keydown, post a 
// notification message to the 
// client window, 
if( IsWindowdpHK[iD.hwnd) ) 
PostMessaged pHK[i ]. hwnd, 
wm_hotkeypressed,wKey, 

1pHKEi].1Param): 

} 

return 1; // discard key message 

} 

} 

} 


void RemoveVirtualHotKeyi DWORD hHotKey ) 

// undefines a hot key with VHKD.386 
// entry: hHotKey is 32 bit handle returned 
// by AddVirtualHotkey!) 
f 

if( !1pfnVHKD ) return; // no API 

_asm mov ax,2; // VHKD API function 2 

_asm mov bx.word ptr [hHotKey]; 

_asm mov cx.word ptr [hHotKey+2]; 

_asm call [1pfnVHKD]; // call VHKD API 


void RemoveKeyHookI void ) 

// removes Windows keyboard hook and 
// undefines hot keys with VHKD.386 
( 

int i; 


Sax Comm Objects lets you 
write Windows comm, apps 
in no time * 


// give other hooks a crack at the message 
return CallNextHookExthKeyHook.nCode.wKey, 1 Param); 


DWORD AddVirtualHotKeyC WORD wHotKey ) 

// define a hot key with VHKD.386 
// entry: wHotKey = hot key descriptor 
// returns: 32 bit handle 
{ 

WORD wScan; 

WORD wState = 0; // shift key state 
if( !1pfnVHKD ) // no API. nothing to do 
return 0; 


With Sax Comm Objects, you can save time and add value to 
your Windows applications by plugging in high-level, 
royalty-free comm, objects. 

• X,Y,ZModem, Kermit, CompuServe B+ File transfers 

100% in the background with optional status dialog box 

• Color Ansi, VT52, VT100, TTY emulations with 
capturing, scroll back, and mouse selection. 

• Modem database with over 100 modems, extensive 
modem control functions 


// convert virtual key to scan code 
wScan * MapVirtualKey(LOBYTEIwHotKey),0); 
// convert Modifier key bit mappings 
iff wHotKey 4 SHIFTJIT ) 
wState I* 1: 
if( wHotKey 4 ALTJIT ) 
wState 1= 0x100; 
if ( wHotKey 4 CONTROLJIT ) 
wState |= 0x80: 

_asm mov ax.l 
_asm mov bx,[wScan]; 

_asm mov cx,[wState]; 

_asm call [1 pfnVHKD]; 

// result in dx:ax 

fifdef _BORLANDC_ 

// to remove warning 
return ((DWORD)_DX«16) l_AX; 

#endif 


// VHKD API function 1 
// pass scan code 
// pass state 
// call API 


• Common Dialogs for Communications for dial status, port 
settings, dial directory, etc... 

Don’t waste another minute with cumbersome, old-fashioned 
programming when Sax Comm Objects can be yours for only 
$299. Call 1-800-MIKESAX for more information. 


* well... ok, maybe five minutes. 


Supported Platforms 



V* 


Visual C/C** 

Borland C/C++ 

Microsoft 

DLL ot MFC 

DLL or OWL 

Visual Basic 

¥ 

H 


FoxPro for Windows 

Paradox lor 
Windows 

Microsoft Access 



SOFTWARE 


1-800-MIKESAX 

Fax: 202-785-3607 Visa/MC welcome 
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Listing 2 continued 


// remove virtual hot keys 

// hot keys added by window 

for(i=0;i<nHotKeys;i++) 

{ 

if( lpHK[i].hHotKey ) 

int i. j; 

RemoveVirtualHotKeyd pHK[i ] .hHotKey): 

int result - 0; 

// remove hook 

RemoveKeyHookt); 

if(hKeyHook) 

fort i=0;iKnHotKeys;i++) { 

UnhookWindowsHookEx(hKeyHook): 

ift lpHK[i].hwnd == hwnd &A 

hKeyHook = NULL: 

( lpHKti],wHotKey == wHotKey II wHotKey == 0 ) ) 

) 

// remove entry from list 


fort j = i+1; jknHotKeys; j++ ) 

BOOL InstallKeyHookt void ) 

1 pHK[j- 1] = 1 pHK[j ] ; 

// installs Windows keyboard hook and defines 

nHotKeys--; 

// hot keys with VHK0.386 

result * 1; 

( 

// resize the memory 

int i; 

if(nHotKeys ) 

if( hKeyHook ) 

farrealloctlpHK.sizeof(HOTKEYSTRUCT)*nHotKeys ) ; 

RemoveKeyHookt ) ; 

else 

if( InHotKeys) return FALSE; // no need to install hook 

farfreetlpHK); 

// install virtual hot keys 

InstallKeyHookt); 

for(i=0;i<nHotKeys;i++) 

return result; 

lpHK[i],hHotKey = AddVirtualHotKeyd pHK[i ] .wHotKey ) : 

) 

// install hook 


hKeyHook ■ 


SetWindowsHookExfWH KEYBOARD.HotKeyHook.hInst.NULL); 

LRESULT CALLBACK export ShellHookt int nCode. 

return (hKeyHook!=NULL); 

WPARAM wParam, LPARAM IParam ) 

) 

// shell hook to put our keyboard hook first 


// after another app starts. 

int WINAPI .export AddHotKeyl HWND hwnd, WORD wHotKey, 

if ( nCode == HSHELLJINDOWCREATED ) { 

LPARAM IParam ) 

RemoveKeyHookt); // reinstall keyboard hook to put 

// adds a hot key to the list 

InstallKeyHookt) ; // our hook at the top of the list 

// entry: hwnd * windows to post notfication 

} 

// wHotKey = hot key descriptor 

return CallNextHookExthShel1 Hook,nCode, 

// low byte = virtual key code 

wParam,IParam); 

// high byte = modifier flags 

} 

l 

int result « 0: 

BOOL GetVHKDEntryPointt void ) 

int i; 

// get the API entry point VHKD.386 if installed 

if ( HsWindow(hwnd) ) return 1; // invalid hwnd 

// test for enhanced mode windows 


ift (GetWinFlagsO & WF ENHANCED) == 0 ) 

RemoveKeyHookt): // remove the hook 

return FALSE; 


// get entry point for VHDK API 

// allocate memory for the new item 

asm mov ax. 1684h; 

if ( nHotKeys == 0 ) 

asm mov bx. VHKDID 

lpHK = farmal loctsizeof(HOTKEYSTRUCT) ); 

asm int 2fh 

ift lpHK == NULL ) 

.asm mov word ptr [1pfnVHKD]. di; 

result * -3: // out of memory! 

asm mov word ptr [1pfnVHKD+2], es: 

else { 

return lpfnVHKO != NULL; 

LPHOTKEYSTRUCT IpHKnew = 

) 

farrealloctl pHK,sizeof(HOTKEYSTRUCT)*(nHotKeys+l) ): 


ift IpHKnew == NULL ) 


result = -3; // out of memory! 

#pragma argsused 

else 

int FAR PASCAL LibMaint HINSTANCE hlnstance, WORD wOataSeg, 

lpHK = IpHKnew; 

WORD cbHeapSize. LPSTR lpCmdLine) 

/ 

ift result == 0 ) { 

l 

hlnst = hlnstance; 

// save the hot key data 


1pHK[nHotKeys].hwnd = hwnd; 

// get entry point for VHKD 

lpHK[nHotKeys],wHotKey = wHotKey; 

GetVHKDEntryPointt); 

lpHK[nHotKeys], IParam * IParam: 

// register notification message 

nHotKeys++; 

wm.hotkeypressed = RegisterWindowMessage(HOTKEYPRESSED); 

// check for a duplicate key 

// install shell hook 

for(i=0;iKnHotKeys-1;i++) { 

hShel1 Hook * 

ift lpHKti].wHotKey — wHotKey ) { 

SetWindowsHookExtWH.SHELL.Shel1 Hook.hlnst,NULL); 

result « 2; 

return 1; 

break; 

) 

) 

} 

^pragma argsused 

result » 1; 

int CALLBACK .export WEPt int n ) 

InstallKeyHookO; // install the hook 

l 

// remove shell hook 

return result; 

if(hShel1 Hook) 

) 

UnhookWindowsHookExthShel 1 Hook); 


RemoveKeyHookt); // remove hook if needed 

int WINAPI .export RemoveHotKeyt HWND hwnd, WORD wHotKey ) 

return 1: 

// remove a hot key from the list 

} 

// entry: hwnd = owner of hot key 

/* End of File */ 

// wHotKey » hot key descriptor or 0 for all 



Page 62 — Windows/Dos Developer’s Journal 


January 1995 






The WM_GETHOTKEY message takes a wParam of 0 and 
IParam of 0, and returns the 16-bit value which describes 
the hot key. If it returns 0, there is no hot key associated 
with the window. 

Your application can use the MM_SETHOTKEY message to 
assign a hot key to itself, or set the hot key of another 
application, hotkey, c (Listing 1), is a Windows program 
which sets the hot key 'Alt+Ctrl+Shift+H' for its main win¬ 
dow. 

If you want to define multiple hot keys (as, for exam¬ 
ple, a program launcher might), then MM_SETHOTKEY is not an 
appealing interface, since it requires a unique window 
handle for each hot key that you define. You could create 
a new, hidden window for each new hot key, but that 
would use up precious space in one of Windows' fixed- 
size heaps. Another drawback to UM_SETHOTKEY is that an 
application that does not pass HM_SYSCOMMAND messages on 
to DefUindowProcO could prevent your hot keys from work¬ 
ing. 

Using a Windows Hook 

The Windows API provides SetUindowsHookExO for set¬ 
ting different types of hooks (functions that get called 
when specific events happen) in an application. This is the 
Windows 3.1 successor to the Windows 3.0 function 5et- 
MindowsHookO, and the following discussion applies to the 
earlier function as well. The MH_KEYBOARD system-wide hook 
is useful for capturing a hot key from another Windows 
application. Windows calls a keyboard hook when the ac- 


Listing 3 hotkeyhk.h — Interface for hotkeyhk.dll 


I* hotkeyhk.h - APIs for hotkeyhk.dll 
copyright 1994 Robert Mashlan 

*/ 

int WINAPI RemoveHotKeyl HUND hwnd, WORD wHotkey ); 

int WINAPI AddHotKeyl HWND hwnd, WORD wHotkey. LPARAM IParam ); 

// bit definitions for upper byte of hot key descriptor 
#define SHIFTJIT 8x8100 

#define CONTROLJIT 0x0200 

#define ALT_BIT 0x0400 

// string to register for notification message 
#define HOTKEYPRESSED "wm_hotkeypressed" 

/* End of File */ 


tive application calls GetMessageO or PeekMessageO and is 
about to retrieve a UM_KEYDOUN or MM_KEYUP message. Al¬ 
though the SDK documentation doesn't state this, this is 
also true for UM_SYSKEYDOUN and WM_SYSKEYUP messages; oth¬ 
erwise, it would not be possible to capture a hot key with 
the Alt key pressed or other system keys such as F10, 
which is used to access the menu bar in an application. 

When you call SetklindowsHookExO to create a keyboard 
hook, you must pass the address of a function. Windows 
calls your function, passing in wParam the virtual key code 
of the key that was pressed, and passing in IParam the 
keyboard message flags. These are the same parameters 
that will be passed to the keyboard message being retrieved 


Lillie fliglcin 
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$75 total software cost! ^ 

No matter how many nodes! <T < 
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Mixed mode routing 
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Use with windows 
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- Supports printing & clipboard 
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- Creates buttons from bitmaps 
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- 3D buttons w/ color customization 
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Ribbon 
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Field Validation 

- Validates date, time, number fields 
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needle or color bar as indicators 
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Table 
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editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

- Colored progress bar 

- Show date, time, & key states 


Source code for the 
Borland 3D Chart is available! 



Split windows 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 
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Table 3 VKD services for hot keys 

Service 

Description 

VKD Define Hot Key 

Define a hot key notification routine. 

VKD_Remove_Hot_Key 

Removes a hot key notification routine installed with 

VKD Define Hot Key. 

VKD Local Enable Hot Key 

Enable a local hot key in the specified VM. 

VKD LocaLDisabIe Hot Key 

Disable a local hot key in the specified VM. 

VKD_Reflect_Hot_Key 

Reflect a hot key into a specified VM and exit hot key 
state. This service is normally called by a hot key 
notification call-back routine. It allows the call-back to 
send the hot key into a VM and pretend that it wasn't 
really recognized as the hot key. 


by the active application. The hook procedure can return 
0 if the message is to be processed by the application, 
and 1 if the message is to be discarded. 

You should generally place your keyboard hook in a 
DLL, as with any code that may be called at runtime in 
the context of some other application's stack. You could 
place the hook procedure in your application's .exe, but 
you would have to work harder to force the compiler to 
generate the code to load the correct value into the DS 
register (normally, the function prologue code in a .exe 
would load the DS from the stack segment register, which 
would be disastrous for a system-wide hook procedure). It 


is easier and more maintainable to 
just put the hook procedure in a DLL. 

Within a hook procedure, it is a 
good idea to execute as little code as 
possible; for the hot key implementa¬ 
tion, your code should simply post a 
message to the window that wishes 
to be notified of the hot key activa¬ 
tion. Hook code executes in the con¬ 
text of another task, and doing 
things such as allocating memory 
may not be healthy for your applica¬ 
tion when the other task terminates. 
You may also run the risk of generat¬ 
ing a GPF for some other task, when 
your application is really the one to 
blame. 

A problem with using a keyboard 
hook is that GetKeyStateO doesn't seem to work properly 
within the keyboard hook procedure. According to the 
SDK documentation, GetKeyStateO retrieves the state of a 
virtual key at the time of a keyboard message and should 
only be called in response to a keyboard message. Even 
though the keyboard hook is being called when the appli¬ 
cation is about to retrieve a keyboard message, Windows 
must be doing something after the keyboard hooks are 
called that causes problems. I work around this by main¬ 
taining my own key state information. In hotkeyhk.c (List¬ 
ing 2), the keyboard hook procedure, HotKeyProcO, checks 



BANISH MEMORY LEAKS 


Are you developing WIN 16 or WIN32 
apps in Microsoft or Borland C++? 

Are you tearing your hair out trying to 
track down memory allocation errors? 

Do you suspect your apps are 
eating memory? 

It will automatically validate your use of 
will even write a stack trace, showing 
precisely where you allocated memory, then failed to free it. This feature 
is so useful, you will wonder how you ever managed without it. 


If so, you need NewTrack™ v3. 
dynamic memory. NewTrack™ 



Case History #14 

Andy Richards writes big MS-Windows apps 
He suspected his new app was eating 
memory, so he tried the evaluation version 
of NewTrack™. 

This proved he had problems, but he needed 
to know more, fast. Andy phoned us at 
10:00 AM on Friday 21st October. 

He faxed us his credit card order, and at 
11:15 AM we emailed his personalized copy 
of NewTrack™ vio CompuServe, ond he got 
to work. Next Monday, he 
handed over his product with the memory 
leaks fixed. 


Free test drive! 

You can obtain an evaluation copy of 
NewTrack™ from CompuServe. It could 
also be on your favorite bulletin board. 

Here's where it is on CompuServe: 

Microsoft Visual C++ 

GO MSLANG 

Library #2, Microsoft C++ 

File NTK3MS.ZIP uploaded 28-Jun-1994 

Borland C++ 

GO BCPPWIN 

Library #6, Debugging Tools 

V3.1 NTK3B3.ZIP uploaded 28-Aug-1994 

V4.02 NTK3B4.ZIP uploaded 05-Sep-1994 


CAVENDISH SOFTWARE Don't believe us-test it today. 
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liiHireffTfS 


Introducing TreeBuilder, a revolutionary ‘Custom Control' 
for adding smart, colorful trees to your Windows apps in 
minutes. Use it to create Browsers, Decision Trees, Organiza¬ 
tion Charts, Outliners, and to logically organize any kind of 
hierarchical data. Treebuilder provides over a dozen 
combinations of tree styles. Data can be stored in individual 
nodes. User defined nodes, links, bitmaps, colors and fonts 
create a unique look. Trees can be stored in files and copied 
to the Clipboard. DLL version for Resource Workshop & 

Dialog Editor, VBX version for Visual Basic & Visual C++. 

Each version for $229 (royalty free), both for $299. 30 days, 
no-hassle, money-back guarantee. Call toll-free 24 hours: 

Visualsoft 

124 Cabrillo Street, 
San Francisco, CA 94118. 


(800)-662-0831 or 

(415)-565-4491. 

Fax: (415)-221-8610. 

Demo BBS: (415)-386-7946 
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for the modifier keys VK_C0NTR0L, VK_SHIFT, and VK_MENU (the 
Ait key). The static variable ModKeys is a bit-mapped WORD 
updated to reflect the state of these keys whenever they 
are pressed or released. 

Your hook function should almost always call the next 
hook function in the chain, but the SDK documentation is 
not very clear on this point. As a result, I have seen seen 
a few bad implementations of keyboard hooks intercept¬ 
ing a hot key. Because these bad implementations do not 
chain to other keyboard hook procedures by calling 
CallNextHookExO, any hooks installed after the bad hook 
will not be notified of the keyboard message! The SDK 
documentation creates confusion by 
stating that the hook function should 
return 0 if the application is to proc¬ 
ess the message: what it should say 
is that the function should return the 
result of CallNextHookProcExO if it is 
not interested in the message. The 
SDK documentation also claims that 
the first parameter of the hook func¬ 
tion 'specifies whether the callback 
function should process the message 
or call the Ca 1 INextHookEx function.. . . 

If this value is less than zero, the call¬ 
back function should pass the mes¬ 
sage to Cal INextHookEx without further 
processing.' The wording here seems 
to imply that this is the only condi¬ 
tion under which your code should 
chain to the next hook. 

Even if another application's hook 
procedure is creating the problem (by 
not calling the next hook), to the 
user it may simply appear that your 
program is not correctly hooking hot 
keys. Therefore, you may want to try 
to defend yourself against bad imple¬ 
mentations. One solution, by no 
means foolproof, is to install yet an¬ 
other hook, this time a shell hook, by 
specifying UH_SHELL to SetWindow- 
sHookExO. This hook will provide noti¬ 
fication when a top-level unowned 
window is created. Usually, though 
not always, applications install hooks 
when the main application window is 
created, so this is a good place to re¬ 
move your keyboard hook and rein¬ 
stall it such that it is first in the hook 
chain, hotkeyhk.c (Listing 2) does this 
by installing the shell hook in Lib- 
MainO and removing it in the WEPO. 


Listing 4 

services 


vhkd.asm —A VxD for accessing VKD 
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listing 4 - vhkd.asm vhkd.386 code 
copyright 1994 Robert Mashlan 

***★***★★★★********★**★★**★**★★*★★****★★*★**★**★**★★***★★* 
TITLE VHKD - Virtual Hot Key Services 

. ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A:****** 

.386p 
.XLIST 

INCLUDE vmm.inc 
INCLUDE vkd.inc 
INCLUDE debug.inc 


A Hot Key DLL 

You can compile hotkeyhk.c (List¬ 
ing 2) into a DLL called hotkeyhk.dll. 
The DLL provides an API for an appli¬ 
cation to capture a hot key and have 


Rev Up Database 
Programming 

with Greenleaf Database Library 



Powerful Functions 


The SoftC Database Library 
is now the new Greenleaf 
Database Library. 
Unsurpassed speed and 
flexibility for access to 
industry standard database 
data, index, and memo files 
at an affordable price. 
Databased Advisor says, 
"SoftC Database Library has 
top ratings!" 

Don't be fooled by pretty 
ads—the Database Library is 
all you need to interface 
with dBASE III, dBASE IV, 
FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files 
including new FoxPro CDX 
index files. 

Supports MS-DOS, 
Windows™, and is portable 
to OS/2, UNIX. 

Includes Windows 3.1 DLL, 
supports Microsoft, Borland 
and Zortech C/C++. 

Single and Multiple User; 
Network acccess fully 
supported. 

Database package not 


required—this product is a 
complete ISAM library. 
Windows DLL linkable with 
most DLL-capable compilers 
(including Visual Basic). 


All Greenleaf Libraries Feature: 

□ No royalties 

□ 90-day money-back guarantee 

□ FREE unshrouded source (ANSI & K&R) 

□ FREE unlimited tech support 

□ Top rated documentation AND online 
documentation with FREE help engine! 

□ FREE BBS access, quarterly newsletter 

□ GOLD support available: toll-free access to 
BBS, tech support and free updates—call for 
prices 

Database Library v3.22 .. $249 

"S' Call today for complete infor¬ 
mation, demo, or to order. Mas¬ 
terCard, VISA, AmEx, approved 
purchase orders. 

1 - 800 - 523-9830 

214-248-2561 
FAX 214-248-7830 
BBS 214-250-3778 

Greenleaf Software, Inc. 

16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 

m 

GREENLEAF 
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Listing 4 continued 


.LIST 

VHKD_Device_ID = 331bh 
VHKD_Version_Major = 1 
VHKD_Version_Minor = 0 

Declare_Virtual_Device VHKD.VHKD_Version_Major,\ 
VHKDJersIon_Minor.VHKD_Control.VHKD_DevicejD,.\ 
VHKD_Api_Proc,VHKD_Api_Proc 


VxD_DATA_SEG 


(Listing 4 continued on page 68) 


notification of that hot key sent to a specified window. 
The function AddHotKeyO takes a hot key descriptor UORD, a 
window handle for notifications, and an IParam for any ad¬ 
ditional data you want passed when the hot key is de¬ 
tected. AddHotKeyO returns an error code that is the same 
as the return value from UM_SETHOTKEY, with the added pos¬ 
sible result of -3 for an out-of-memory error. 

When the user presses one of the hot keys you have 
registered with AddHotKeyO, the DLL posts a notification 
message to the window, with wParam set to the hot key 
descriptor and IParam set to the reference data. For a mes¬ 
sage number, I use a registered window message called 
"wm_hotkeypressed', defined in hot- 
keyhk. h (Listing 3). 

You can remove a hot key by call- 


Quadbase-SQL leads the 
pack in ODBC + DBMS 

gmuadbase-SQL is an industrial strength, ANSI 
iH SQL 89 level 2 client/server RDBMS. Now it 
provides a unique ODBC driver that delivers 
superior performance by serving as a native API. 

To build applications, you can 

use the Quadbase-SQL Client 
Development Kit for Windows 
(which includes the local SQL 
engine as well as a set of 
powerful tools) with 
popular languages such 
as Visual Basic, C/C++ 
as well as any ODBC 
compliant front-ends/ 
languages such as 
ACCESS, FOXPRO 
for Windows, 

PowerBuilder, etc. 

Visual Basic development is enhanced by embedded SQL and bound custom controls. 

An interactive query tool/report-writer for Windows is included for quick prototyping and 
database administration and maintenance. A ‘C’ language API is also provided together with 
an embedded SQL preprocessor. 

You can deploy your applications in any environment from individual notebooks or desktops 
to peer-to-peer or client/server LANs. Quadbase-SQL XB Server (our client/server version) 
is available for both Novell Netware and Window NT. 

Advanced features of the SQL engine include declarative referential integrity with 
CASCADE, SET NULL and RESTRICT options, scroll cursors, SQL 2 compliant multi-table 
outer join, concurrency control through 4 isolation levels, crash recovery, transaction 
processing, BLOB data-type, and read-only schemas for CD ROMs. The high-performance 
engine is especially designed to manage large amounts of data efficiently. The Xbase file 
format allows easy migration from Xbase enivornments. 



Call for a free demo disk now. 

Find out why AT&T, 
Airbus, EPA, Xerox 
and many more major 
organizations use 
Quadbase products. 



Quadbase Systems, Inc. 

790 Lucerne Dr., Suite 51 
Sunnyvale, CA 94086 

Tel: (408) 738-6989 

Fax: (408) 738-6980 
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ing RemoveHotKeyO with the hot key 
descriptor and the window handle. If 
the hot key descriptor is 0, then all 
hot keys hooked by that window will 
be removed. An application should 
remove all of its hot keys when the 
application terminates. 

Using the VKD to Hook a 
Hot Key in a DOS Box 

hotkeyhk.dll would not be as use¬ 
ful if it only relied on keyboard 
hooks. The problem is that a system- 
wide keyboard hook does not get 
notified of key presses that take 
place in a DOS box. The reason for 
this is the way enhanced-mode Win¬ 
dows works. At the lowest level en¬ 
hanced-mode Windows multitasks 
one or more virtual machines (VMs), 
using the virtual 8086 capability of 
the 80386. All Windows applications 
run in the first VM (called the system 
VM), and each DOS session gets a 
separate VM so that it believes that it 
has the first megabyte of memory all 
to itself. Each of these virtual ma¬ 
chines is preemptively multitasked, 
unlike the cooperative multitasking 
implemented for Windows applica¬ 
tions. 

In enhanced-mode Windows, vir¬ 
tual device drivers are used to man¬ 
age resources such as a hardware 
devices, or the BIOS, or MS-DOS, 
since these resources may be limited 
and/or not designed to be called si¬ 
multaneously by different virtual ma¬ 
chines. For instance, a virtual device 
driver for the hard disk will serialize 
all requests to use the disk, thus pre¬ 
venting two different virtual ma¬ 
chines from using the hard disk si¬ 
multaneously. A virtual device driver 
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protects the DOS kernel from being 
reentered, since it was not designed 
to be reentrant. 

The VKD is the virtual keyboard 
device driver, which is used to access 
the hardware keyboard from several 
different virtual machines. Only one 
virtual machine - the virtual machine 
with the input focus - owns the key¬ 
board at a given time, and only that 
machine receives key strokes from 
the keyboard. Thus, if a DOS box has 
the input focus, the system virtual 
machine containing Windows appli¬ 
cations will not receive any keyboard 
messages. This is why a Windows 
keyboard hook will not trap a hot 
key while a DOS box has the input 
focus. 

Fortunately, the VKD device driver 
exports some services that allow hot 
keys pressed in a DOS box to be re¬ 
flected to another virtual machine 
(this is how Ctrl+Esc, Alt+Tab, and 
other system hot keys still work from 
a DOS box). However, these services 
are directly accessible only from an¬ 
other VxD running in ring-0 mode. 
Application code, which runs at a 
lower privilege level, cannot directly 
call this code - it will cause a proces¬ 
sor fault. The VKD services of inter¬ 
est, shown in Table 3, are nicely 
documented in the vkd.asm source 
code, which is included with the Win¬ 
dows DDK. These services are called 
by the Shell VxD, which, in turn, pro¬ 
vides API services to the WINOLDAP. 
API services can be called from appli¬ 
cation code with a lower privilege 
level via a special gateway. The Shell 
VxD's API service allows WINOLDAP 
to set hot keys when a DOS box is 
created. Unfortunately, the undocu¬ 
mented API of the Shell VxD doesn't 
provide a straightforward way to use 
the VKD hot key services from Win¬ 
dows. 

vhkd.asm (Listing 4) is the source 
code to a virtual device driver called 
vhkd.386. vhkd.386 is not really a de¬ 
vice driver; its purpose is to provide 
an API function to access the privi¬ 
leged services in the VKD. The driver 
is installed by placing the line 'de- 
vice=[path]\vhkd.386' in the 
'386Enh' section of system, ini. Win¬ 
dows application code, or any pro- 
tected-mode or DOS application, can 
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Listing 4 continued 



; API service table 


API Services 

label dword 


dd 

0FFSET32 VHKD API GetVersion 

; [0] 

dd 

0FFSET32 VHKD API Add Hot Key 

; [1] 

dd 

0FFSET32 VHKD API Remove Hot Key 

; [2] 


Max_Api_Services = 3 

VxDJATAJNDS 

VxD_CODE_$EG 

BeginProc VHKD_Api_GetVersi on 
; return version number 


mov 

ah,VHKD_Version_Hajor 

mov 

al,VHKD_Version_Hinor 

mov 

[ebp.Client_AX],ax 

and 

[ebp.Client_Flags]. NOT 

ret 


EndProc 

VHKD_Api_GetVersion 

BeginProc 

VHKD_Hot_Key_Ca 11 back 


hot key call back - called when one of our defined 
hot keys gets pressed 
on entry 

al = scan code of key 

ah = state of key (will be called with 0 for press) 

ebx = hot key handle 

ecx * global shift state 

edx = reference data - defined hot key’s VH 


mov 

eax.ebx 

; hot key handle 

mov 

ebx,edx 

; get hot key’s VH 

push 

edx 

; save VH handle 


; this service uses EAX=hot key handle, 

; EBX= hot key's VM, and CX=shift state 
VxDcall VKD_Reflect_Hot_Key 

; reflect to hotkey's VH 

VMHcall Get_$ys_VM_Handle 

; get system VH handle 
; in ebx 

mov esi.0FFSET32 VHKD_Activate_VM 
pop edx ; pass hot key's VH to 

; active it on press 

VHHcall Call_VH_Event 
ret 

EndProc VHKD_Hot_Key_Ca11 back 

BeginProc VHKD_Activate_VH 


jnc 

short no_def_err 

xor 

eax.eax ; error, return null handle 

no_def_err: 


mov 

edx.eax ; return result in dx:ax 

shr 

edx.16 

mov 

[ebp.Client_EAX],eax 

mov 

[ebp.Client EDX],edx 

and 

[ebp.Client_Flags], NOT CF_Hask 

ret 


EndProc 

VHKD_Api_Add_Hot_Key 

BeginProc 

VHKD_Api_Remove_Hot_Key 

; cx:bx = hot 

key handle to remove 

mov 

ax,[ebp.Client_CX] 

shl 

eax,16 

mov 

ax,[ebp.Client_BX] 

cmp 

eax,0 

jne 

short skip_remove 

VxDCall VKD_Remove_Hot_Key 

skip_remove: 


and 

[ebp.Client_Flags], NOT CF_Mask 

ret 


EndProc 

VHKD_Api_Remove_Hot_Key 

BeginProc VHKD_Api_Proc 

movzx 

eax,[ebp.Client_AX] ; get function no. 

cmp 

eax,Hax_Api_Services 

jae 

short service_error 

call 

API_Services[eax*4] 

ret 


service_error: 


or 

[ebp.Client_Flags], CF_Hask 

ret 


EndProc VHKD_Api_Proc 

VxD_CODE_ENDS 


VxD_LOCKED_CODE_SEG 

BeginProc 

VHKD_Control 

clc 


ret 


EndProc 

VHKD_Control 


VxD_LOCKED_CODE_ENDS 


; called in context of the system VH - set focus 
; to the hot key's VH passed in edx. Set Focus may only 
; be called in the context of the system VH. 

mov ebx.edx 

VHHcall $et_Execution_Focus 

ret 

EndProc VHKD_Activate_VH 

BeginProc VHKD_Api_Add_Hot_Key 

; this service is called with 
; entry 

; bl = scan code 
; cx = shift key state 
; returns 

; dx:ax = hot key handle 

mov edx,ebx ; save VH handle 

; as reference data 
mov al ,[ebp.Client_BL] ; scan code 

mov ah,0ffh ; use either ext/normal 

mov bx,[ebp.Client_CX] ; get shift state 

shl ebx,16 ; put in both 

mov bx.cx ; upper and lower words 

mov cl.CallOnPress 

mov esi. 0FFSET32 VHKD_Hot_Key_Cal1 back 

xor edi.edi ; elapse time 

VxDCall VKD_Define_Hot_Key 


VxD_REAL_INIT_SEG 


BeginProc VHKD_Real_ 

_Init_Proc 


test 

bx, Duplicate. 


jnz 

short dupl 

xor 

bx, 

bx 

xor 

si, 

si 

xor 

edx, 

, edx 

mov 

ax, 

Device_Load_Ok 

ret 



duplicate: 



mov 

ax. 

Abort_Device_Load 


loaded 

te ; jump if so 

no exclusion 
tbl 

no instance 
data table 
no reference data 


ret 

EndProc VHKD_Real_Init_Proc 


VxD_REAL_INIT_ENDS 

END 

; End of File 
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access the services provided through the API procedure, 
which is retrieved using INT 2Fh, with AX=1684h and BX equal 
to the VxD ID, which is unique to the VxD (assigned by 
Microsoft). 

vhkd.386 provides three services through its API proce¬ 
dure. The API procedure can be used both by protected- 


mode and V86-mode (used by DOS programs) applica¬ 
tions. So it is possible for a DOS program to define a hot 
key for itself when running under enhanced-mode Win¬ 
dows. The API procedure is called with a function number 
in the AX register. 


Listing 5 hktest.c — Test application using hotkeyhk.dll 



I* listing 5 - hktest.c Test application for hotkeyhk.dll 
copyright 1994 Robert Mashlan 

*/ 

//define STRICT 
//include <windows.h> 

//include <string.h> 

//include "hotkeyhk.h" 

// define three test hot keys 

//define H0TKEY1 ALT_BIT+CONTROL_BIT+SHIFT_BIT+VK_F2 

//define H0TKEY2 ALT_BIT+CONTROL_BIT+’A’ 

//define H0TKEY3 ALT_BIT+SHIFT_BIT+VK_NUMPAD5 

LRESULT CALLBACK .export MainWndProc! HWND hwnd, UINT msg. 
WPARAM wParam, LPARAM 1Param ) 

{ 

static UINT wm.hotkeypressed; // notification message 
switch(msg) { 
case WM.CREATE: 
wm.hotkeypressed = 

RegisterWindowMessage(HOTKEYPRESSED); 

// active the hot keys 
AddHotKey(hwnd.H0TKEY1.1): 

AddHotKey(hwnd,H0TKEY2.2); 

AddHotKey(hwnd,H0TKEY3,3); 
return 0: 

case HM.DESTROY: 

RemoveHotKey(hwnd.0); // remove all hot keys 

PostQuitMessage(0); 

return 0; 

default: 

if( wm.hotkeypressed && msg == wm.hotkeypressed ){ 
// beep and display message 
MessageBeep<0); 

MessageBox(hwnd."Hot Key Pressed!", 

"Hot Key Test",MB_0K); 
return 0; 

} 

} 

return DefWindowProcIhwnd,msg,wParam,1Param); 


int MessagePump(void) 

{ 

HSG msg; 

while! GetMessageUmsg,NULL.0,0) ) { 
TranslateMessage(&msg); 
DispatchMessageUmsg); 

} 

return msg.wParam; 


//pragma argsused 

int PASCAL WinMain! HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR IpstrCmdLine, int nCmdShow ) 

{ 

char szClassNameC] = "Hot Key Test"; 

HWND hwnd; 


if!!hPrevInst) { 
WNDCLASS wc; 


memset!iwc.0,sizeof(wc)); 
wc.hbrBackground = (HBRUSH)(C0L0R_WIND0W+1); 
wc.hCursor = LoadCursor(NULL,IDC_ARR0W); 
wc.hlcon = LoadIcon(NULL,IDI_APPLICATION); 

wc.lpfnWndProc = MainWndProc; 

wc.lpszClassName = szClassName; 

wc.hlnstance = hlnst; 

RegisterClass(Awc); 

} 

hwnd * CreateWindowtszClassName,szClassName, 

WS_0 V E RLAP P E DWIN DOW, 

CW_USEDEFAULT,CW.USEDEFAULT.250,250. 
NULL,NULL,hlnst,NULL); 

if(hwnd) { 

ShowWindow!hwnd.nCmdShow); 

UpdateWindow!hwnd); 
return MessagePumpO; 

} 

return -1; 


/* End of File */ 


FXTools/VB Professional 

The Ultimate Multimedia Playground for Visual Basic 



Features nine of the HOTTEST multimedia custom controls. 
Display images, text, shapes, and video with 100 main, transition, 
and multiple pass dissolve effects includ ing wipes, blinds, splits 

diagonals, and rolls. 
Displays 19 image file 
formats including BMP, 
PCX, GIF, TGA, TIF, 
JPEG, CMP and FIF. 
Displays AVI and 
QuickTime video with 
effects. Supports WAV 
and MIDI sound. Also 
included are 3D Fonts 
with block shadows, 3D 


borders, rotated text, image transparency, and much more. 


FXTools/VB Professional and Visual Basic provide an ideal 
platform for multimedia development, CD-ROMs, computer 
based training, interactive kiosks, presentations, and demos. 
Only $349.00. FXTools/VB Standard Edition contains four 
custom controls that feature 50 professional effects for 
images, text and shapes. Five popular image file formats are 
supported. Only 199.00 
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Function 0 , VHKD_GetVersion, returns a version number 
in AX. This can be used in the future if VHKD is expanded 
to include other API services, and a client application 
wishes to know what API services vhkd.386 provides. 

Function 1, VHKD_Add_Hot_Key, is used to call the VKD_De- 
fine_Hot_Key service. For this function, the scan code of the 
hot key is passed in BL, and the shift states, as defined by 
the VKD service, are passed in CX. The function returns a 
32-bit handle that is used later to remove the hot key. 

Function 2, VHKD_Remove_Hot_Key, is used to remove a hot 
key by calling the VKD_Remove_Hot_Key service. This function 
expects the hot key handle that was previously returned 
by VHKD_Add_Hot_Key. 

The VKDJefine_Hot_Key service requires a callback func¬ 
tion, which the VKD calls when the hot key is pressed, no 
matter which virtual machine is running at the time. In the 
VFiKD driver, the function VHKD_Hot_Key_Callback is used for 
all the hot keys that VFIKD defines. This function calls the 
VKD_Reflect_Hot_Key service, which is used to reflect the hot 
key to a particular virtual machine. The VKD_Define_Hot_Key 
service allows you to pass reference data to the callback 
for each hot key defined; in VFIKD, I pass the virtual ma¬ 
chine handle of the virtual machine that was active when 
the call to VHKD_Add_Hot_Key was made. When the VKD re¬ 
flects a hot key, it simulates all the keystrokes required to 
make it appear the hot key was pressed in the targeted 
virtual machine, in my callback procedure, the hot key is 
reflected to the virtual machine whose handle is passed as 
reference data. 

At this point, I should be able to capture the hot key 
with my Windows hook when the system virtual machine 


executes. Flowever, the current virtual machine may be 
running exclusively, which happens when a DOS session 
is running full-screen and the user checks the 'exclusive' 
box in the DOS box's PIF file or settings dialog. If this is 
the case, the system virtual machine (where Windows ap¬ 
plications run) will not run until the DOS box either gets 
closed or gets switched to windowed mode by the user 
pressing Alt+Enter. To remedy this situation, the callback 
procedure sets the execution focus to the virtual machine 
that defined the hot key. Flowever, the VMM (Virtual Ma¬ 
chine Manager) service Set_Executior>_Focus cannot set the 
execution focus of another virtual machine unless it is 
called from the context of the system virtual machine. I 
use the VMM service Call_VM_Event to switch the context to 
the system virtual machine and call the VHKD_Activate_VM 
procedure, which calls the VMM Set_Execution_Focus serv¬ 
ice. If the DOS session is running full-screen, it gets mini¬ 
mized, so that the Windows system virtual machine can 
run, and can act on the hot key. 

hotkeyhk.dll uses vhkd.386 if enhanced-mode Windows 
is running. In LibMainO, the DLL calls the function GetVHK- 
DEntryPointO, which makes a check for enhanced-mode 
Windows, and then attempts to retrieve the API procedure 
for the VHKD driver. When the Windows keyboard hook 
is installed, a virtual hot key is defined for each hot key in 
the list and stored in the structure HOTKEYSTRUCT associated 
with each hot key. Likewise, whenever the Windows key¬ 
board hook is removed with a call to RemoveKeyHookO, each 
virtual hot key that was previously defined is released 
with a call to RemoveVirtualHotkey0, which calls VHKD_Re- 
move_Hot_Key. 

hktest.c (Listing 5), is the source 
for a Windows application that uses 
hotkeyhk.dll. This application defines 
three hot keys: Alt+Ctrl+Shift+F2, 
Alt+Ctrl+A, and Alt+Shift+Numpad 5. 
When one of these hot keys is 
pressed, the test application beeps 
and displays a message box. 

DOS Sessions in Standard 
Mode 

In Windows standard mode, DOS 
sessions do not use enhanced-mode 
drivers, so vhkd.386 will be of little 
use. in standard mode, the entire 
Windows session is swapped out to 
disk, and the machine switches to 
real mode to handle the DOS ses¬ 
sion. WINOLDAP is able to capture 
hot keys for the Windows session, 
and will perform a task switch if a 
hot key such as Ctrl+Esc is pressed. 
Unfortunately, there doesn't seem to 
an API, documented or undocu¬ 
mented, that can be used to perform 
this task switch. □ 
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Paul Bonneau 


Q l particularly enjoyed your May 1994 W/DDJ article on capturing output 
from a DOS VM ("A VxD to Monitor DOS Output'). I'm glad you've gone a 
long way from posting tech articles to Usenet. I have just a few comments on 
the article, which you might care to address: 

1. You create a data queue structure for each VM, which sounds pretty 
reasonable. You allocate one for each VM and put them in a list which you 
search occasionally. Wouldn't it be better to just make your data structure be 
VM instance data? That way you could index into your data whenever you 
wanted to, rather than doing a search. Am I on track? 

2. You may have the same problem that I was having, which your colleague 
solved in the article that preceded yours (Paula Tomlinson, 'Virtualizing a DOS 
Device Driver with a VxD'). One needs to keep track of the file handle, PSP, 
and the VM; you keep track of the file handle (either 0 or 1) and VM. Because 
you don't also store the PSP, a command like this in a DOS box will produce 
garbage (or at least duplicates): 

dir | more 

The problem is that both dir and more have a stdout file handle, and you are 
trapping writes to both of them. Each task has its own distinct PSP however, 
which you could use to discriminate. If you do, though, which one should you 
use, the dir or the more ? And how would you know about PSPs in the first 
place? 

I guess for a simple thing like capturing the output of a compilation, the 
STDOUT trapping is adequate. If, however, you want to trap what's coming out 
on the screen (as opposed to a particular task's STDOUT), you need something 
more. 

My feeling (before I mothballed the project for a while) was that the best 
thing to do is trap 'console' I/O rather than STDOUT and STDERR. I never 
checked it, but I don't think DOS sends everything through its own console I/O 
functions, so you might have to resort to intercepting messages to the con 
device, and you can't do that without some undocumented DOS (i.e., walking 
the device driver chain and redirecting the I/O handler to your own). Is this a 
reasonable assessment? 

Thanks again for an interesting article. 

Craig Markwardt 
craigm@astrob.physics.wisc.edu 


Send questions to Paul via Internet as 

paul8rdpub.com 

from CompuServe: 

INTERNET: paul8rdpub.com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

The volume of questions and com¬ 
ments for Paul is now such that he will 
be able to respond only to messages 
he will address in the column. He defi¬ 
nitely wants to hear from you - he 
just may not be able to let you know 
that personally. 


A I'm glad to see someone still remembers me from my Usenet days! 

You know, I considered using instance data, but at the time I was consid¬ 
ering it, I thought a 64Kb buffer in the 1 Mb VM space was rude. But I did not 
think of the advantage of direct access to the data. I like your idea better. 

However, from what I can tell, it is up to the caller to specify the area of VM 
memory (conventional memory) that is to be "instanced'. This means that the 
memory range must already have been reserved in the VM. The way this nor¬ 
mally works is that a VxD will have the address of a buffer (perhaps obtained 
during real-mode initialization) residing in a piece of system software in the 
original DOS session. The VxD specifies this address to the virtual machine 
manager during initialization, and the virtual machine manager marks the 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft 

























memory range as instanced. This means that each sub¬ 
sequent VM will inherit a copy of the original VM's in¬ 
stance data, but the new VM's instance data will reside in 
a different physical memory location. 

It is therefore difficult to use instance data for the stor¬ 
age of information not based on some pre-existing mem¬ 


ory location in the original DOS session. But there is a 
close relative of instance data that does not require a pre¬ 
existing range of memory and that can be placed in each 
VM's control block. This memory (if required) must be allo¬ 
cated by a virtual device when its control procedure receives 
the Device_Init message. Such control block memory is 


Listing 1 Revised VxD for capturing DOS output 


. ***************************************************** . 
; WddjTee.asm ; 

; -- VxD traps writes to stdout and stderr and "tees" ; 
; them through a PM callback. ; 

; -- PRB: Modified Sep. 11 '94 to use the VM control ; 
; block to store the per-VM queue. ; 

. ***************************************************** . 

! 386p 

. ***************************************************** . 

: Header files. ; 

. ***************************************************** . 

include vmm.inc 

. ***************************************************** . 

; Constants. ; 

. ***************************************************** • 

wDeviceld equ 31b3h ; Device id from Microsoft. 
bVersionMajor equ 01 ; Major byte of version number. 

bVersionMinor equ 01 ; Minor byte of version number. 

wVersion equ (bVersionMajor * 256 + bVersionMinor) 
cbQueue equ 10000h ; Size of a circular queue. 
nfcVMCreate equ 0 : New VM created. 


nfcVMDestroy equ 1 ; VM destroyed. 

nfcDataReady equ 2 ; Data for VM is available. 

.***************************************************** 
; Data structures. 

.★a*************************************************** 

CQS struc ; Circular Queue Structure. 


hvm 

dd (?) 

; VM handle. 

hsem 

dd (0) 

; Overflow prevention semaphore 

ibHead 

dd (?) 

; Read end. 

ibTail 

dd (?) 

; Write end. 

fFull 

dd (?) 

; If queue is full. 


flnNotify dd (?) ; Client notified of data ready. 

; Array of cbQueue bytes here. 

CQS ends 

.***************************************************** 
; Globals. 

. ***************************************************** 
VxD_L0CKE D_DAT A_S EG 

bcqs dd (0) ; Offset of CQS in Control Block. 
VxD_LOCKED_DATA_ENDS 

VxD_DATA_SEG 

lpfnNotify dd (0) ; Client callback. 

: Protect mode API dispatch table, 
rgpfn label DWORD 

dd offset32 WGetVersion 
dd offset32 CchRead 
dd offset32 RegisterLpfn 
cpfn = ($ - rgpfn) / 4-1 
VxD_DATA_ENDS 

. ***************************************************** 
: Device header. 

.***************************************************** 
Declare_Virtual_Device wddjtee, bVersionMajor, \ 
bVersionMinor, DispatchControl, wDeviceld, \ 
Undefined_Init_Order,, PMApi 

VxD_locked_Code_Seg 

. ***************************************************** 
; Control procedures. 

.***************************************************** 


BeginProc DispatchControl 

.***************************************************** 
; -- Control dispatcher. 

. ***************************************************** 
Begin_Control_Dispatch 
Controlji spatch Devicejnit, VxDInit 
Control_Dispatch VMJnit, VMInit 
Control_Dispatch VM_Terminate, VMEnd 
End_Control_Dispatch 
clc 
ret 

EndProc DispatchControl 
BeginProc VxDInit 

.***************************************************** 

; -- Install the V86 Int 21h hook. 

. ***************************************************** 

; Reserve space in future VM control blocks for 


TM 

TUB Version Control 

For DOS, OS/2 and Windows-NT 
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"...amazingly fast... TUB is a great system." PC Tech Journal 
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products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
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disk support. Mainframe-compatible delta generator for Pansophic, 
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from Opus'" software. 
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reserved through a call to _Allocate_Device_CB_Area(). What 
the call actually does is to reserve space in the control 
block each VM is given as it is created. _Allocate_De- 
vice_CB_Area() returns the offset from the start of a VM's 
control block to the VxD-specific data area. Later, when¬ 
ever a VM is created, the VxD's control procedure can in¬ 
itialize the VxD-specific control block data (upon receipt of 
the VM_Init message). 

I rewrote wddjtee.asm based on this idea. The major 
changes occur in the routines PcqsFindHvmO, PcqsFindVmiO, 
VxDInitO, VMInitO, and VMEndO. The first routine returns 
the address of the queue structure for the given VM han¬ 
dle; the second performs nearly the same function, but 
with a VM identifier as input. The 
control procedure, DispatchControlO, 
calls VxDInitO to handle the De¬ 


Listing 1 continued 

; queue structure. 

VMMcall 

_A11ocate_Device_CB_Area, \ 

«cbQueue + size CQS>, 0> 

or 

eax, eax 

jz short 

VxDInitFail ; Did’na work capt’n! 

mov 

[bcqs], eax ; Rememeber offset. 

; Install 

the V86 int 21h hook procedure. 

push 

esi 

mov 

eax, LF_Use_Heap OR LF_Alloc_Error 

mov 

ecx, cbQueue + size CQS 

mov 

eax, 21h ; Set ISR. 


vi ce_Init message, VMInitO, to han¬ 
dle the VM_Init message; and VMEndO, 
to handle the VM_Terminate message. 

The new version of VxDInitO re¬ 
serves control block memory for the 
queue structure, instead of creating a 
linked list to hold the queues. 
VMInitO initializes the queue structure 
in the current VM - it no longer has 
to allocate a new list node, nor ap¬ 
pend it to the list. VMEndO also gets 
simpler, since it no longer has to de¬ 
tach and free the queue list node. 
PcqsFindHvwO becomes absolutely triv¬ 
ial. It used to search the queue list, 
looking for the queue for the given 
VM. Now all it has to do is add the 
queue offset (obtained during 
VxDInitO) from the given VM's con¬ 
trol block address. But since the con¬ 
trol block address is the same as the 
VM handle, all the routine ends up 
doing is adding the offset to the EBX 
parameter (which is the VM handle 
on input and the address of the 
queue on output). 

PcqsFindVmiO is no more compli¬ 
cated than its predecessor, just differ¬ 
ent. Instead of looping over the linked 
list, looking for the queue correspond¬ 
ing to the given VM ID, it now loops 
over the (circular) VM list, looking for 
the VM whose ID matches the speci¬ 
fied one. When it finds the correct VM, 
it converts the VM handle to a queue 
address using the now trivial 
PcqsFindHvmO routine. PcqsFindVmiO 
uses the convenient VMM services 
Get_Sys_VM_Handle(), Get_Next_VM_Han- 
dleO, and Test_Sys_VM_Handle() to per¬ 
form the iteration. 

Listing 1 contains the new, im¬ 
proved version of wddjtee.asm. I have 
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bumped up the minor version number, so if you plan to 
use this modified version, be sure to update the version 
check in your copy of teedll.c, the DLL that interfaces 
with the VxD. 

The multiple output redirection is a problem. Even 
though the output from dir (in your example) is going to a 


temporary file, it has been redirected from stdout, so 
shows up in the edit control as well as the output from 
more. Trapping output to CON might work, except, as you 
point out, for those applications that write directly to 
video memory. I considered grabbing this output, but it is 
at too low a level. Video memory is random access, so 


Listing 1 continued 


mov esi, 0FFSET32 Int21Hook 

VMMCall Hook_V86_Int_Chain 
pop esi 

ret 

VxDInitFai 1: 
stc 
ret 

EndProc VxDInit 
BeginProc VMInit 

.***************************************************** 
; -- Initialize the circular queue for this VM. 

VMMCall Test_$ys_VM_Handle ; DOS box? 
jz short VMInitDone ; No, so skip. 

; Initialize queue, 
mov eax, ebx 

call PcqsFindHvm 

mov [ebx].hvm, eax 

; Create overflow prevention semaphore. 


L 
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mov ecx, 0 

VMMCall Create_Semaphore 

jc short VMInitDone 

mov [ebx].hsem, eax 

mov eax, nfcVMCreate 

call NotifyClient 

VMInitDone: 

clc 

ret 

EndProc VMInit 
BeginProc VMEnd 

: -- Free the circular queue for this VM. 

. ***************************************************** 

pushad 

call PcqsFindHvm 

; Destroy semaphore, 
mov eax, [ebx].hsem 
or eax, eax 

jz short VMEndDoNotify 
VMMCall Destroy_Semaphore 

VMEndDoNotify: 

; Notify client of VM’s doom. 

mov eax, nfcVMDestroy 

call NotifyClient 

popad 

clc 

ret 

EndProc VMEnd 
BeginProc PcqsFindHvm 

. ***************************************************** 
: -- Return the circular queue for the given VM. 

: -- EBX : VM handle on input, queue on output. 
.******★*★**★**★***★★*★★****★★******★★**★★**★***★*★*** 

add ebx, [bcqs] 

ret 

EndProc PcqsFindHvm 

VxD_Locked_Code_Ends 

VxD_Code_Seg 

.******★*****★★★★*★***★**★★*★★*★★★★★★**★★**★★★★*★*★**★ 
: Procedures. 

. ★*★★*★*★★**★★*★*★**★★★*★★★*★*★★*★★★★★★★***★★★★**★★*★★ 


BeginProc Int21Hook 

. ***************************************************** 

; -- Virtual 86 mode int 21h hook function. 
.***************************************************** 


pushad 


Save regs. 

cmp 

[1pfnNotify]. 0 

Is anyone 

je 

Int21HookNextHandler 

interested? 

mov 

ax, [ebp].Client AX 

Function number. 

cmp 

ah, 40h 

Write? 

jne 

Int21HookNextHandler 

No, so skip. 

VMMCall 

Test_Sys_VM_Handle 

DOS box? 

jz 

Int21HookNextHandler 

No, so skip. 
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how to know when a line of text is being output? How to 
know when to scroll? My solution does not address the 
general problem of how to capture all DOS screen output, 
which is a hard problem. 

I should have mentioned some of these tradeoffs in 
the article itself. Thanks for pointing them out. 


Q I read your article, 'A VxD to Monitor DOS Output.' 

Very interesting. You say some problems of overflow 
may occur. I have to write a VxD which is similar to 
uddjtee.386 (getting some data from DOS boxes to be read 
by a Windows program) and I cannot permit data loss. 


Listing 1 continued 


cmp 

[ebp].Client_BX, 1 ; 

< stdout? 

ji 

Int21HookNextHandler ; 

Yes. so skip. 

cmp 

[ebp].C11ent_BX. 2 ; 

> stderr? 

jg 

lnt21HookNextHandler ; 

Yes, so skip. 

cmp 

[ebp].Client_CX, 0 


jz 

Int21HookNextHandler 


; Find queue. 


call 

PcqsFindHvm 


mov 

edi. ebx 


add 

edi, size CQS ; 

pcqs->rgb. 

add 

edi. [ebx].ibTaii 


; Get linear address of buffer. 


movzx 

esi, [ebp].Client_DS ; 

Src segment. 

shl 

esi, 4 ; 

Linearize 

movzx 

eax, [ebp].Client_DX ; 

plus offset. 

add 

esi, eax 


; Get length of copy. 


movzx 

ecx, [ebp],Client CX ; 

# bytes out. 

call 

CbCqs ; 

# bytes queued. 

neg 

eax 


add 

eax, cbQueue - 1 ; 

# bytes free. 

cmp 

ecx, eax ; 

> queue size? 

jl short 

lnt21Hook0verflowChecked 

mov 

eax. [ebx].hsem 


push 

ecx 


mov 

ecx. Block Svc Ints 


mov 

[ebx],fFull, 1 ; 

Remember fact. 

VHMCall 

Wait_Semaphore 


pop 

ecx 


Int21Hook0verf1owChecked: 


mov 

eax, [ebx],ibTaii ; 

Current write pos. 

add 

eax, ecx ; 

Calculate new 

call 

WMod ; 

write position and 

mov 

[ebx].ibTaii, eax ; 

record it. 

Int21HookGotRead: 


cld 

; 

Prepare for loop. 

mov 

eax, ebx 


add 

eax, cbQueue + size CQS 

Int21HookCopyLoop: 


cmp 

edi, eax ; 

Wrapped? 

jl short 

Int21HookNoWrap ; 

No, we’re ok. 

mov 

edi, ebx ; 

Yes. restart. 

add 

edi, size CQS 


Int21HookNoWrap: 


movsb 

; 

Copy a byte. 

loop 

Int21HookCopyLoop ; 

Until no more. 

; Notify client of new data. 


cmp 

[ebx].fInNotify, 0 ; 

Is one pending? 

jnz short Int21HookNextHandler 


mov 

[ebx],fInNotify, 1 


mov 

eax, nfcDataReady 


call 

NotifyClient 



Int21HookNextHandler: 

popad ; Restore regs. 

stc ; Chain to next. 


ret 

EndProc Int21Hook 
BeginProc CbCqs 

.***************************************************** 
; -- Return the number of bytes in the queue. 

; -- On input : EBX : pointer to CQS. 

; On output : EAX : number of bytes. 

mov eax, [ebx].ibTaii 

sub eax, [ebxj.ibHead 

add eax, cbQueue 

call WMod 

ret 

EndProc CbCqs 
BeginProc MMod 

; -- Return the mod of the input argument (eax) with 
; the queue size (cbQueue) in eax. 
.***************************************************** 

push edx ; Save these guys, 

push ecx 
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Is it not possible to avoid overflow by using the three 
VMM functions Create_Semaphore, Uai ^Semaphore, and Sig- 
nal_Semaphore? I would like to have your opinion because I 
am not an expert on VxDS. 

Jerome LeFebvre 
lefebvre@esker.fr 


A This is an excellent idea, i have incorporated it into 
the revised VxD in wddjtee. asm (Listing 1) as well. One 
potential problem with blocking the running DOS VM is 
that you are interfering with the normal operation of the 
VM scheduler. This could negatively impact responsive¬ 
ness, and make switching between VMs somewhat jerky. 


Listing 1 continued 


xor 

edx, edx 

Clear hi 32 bits. 

mov 

ecx, cbQueue 

Can’t use immediate 

idiv 

ecx 

operand in division. 

mov 

eax, edx 

Get remainder. 

pop 

ecx 

Restore these guys. 

pop 

edx 


ret 



EndProc 

WMod 



BeginProc PMApi, Public 

.*****************************************************. 
; -- Main dispatch point for protected mode API. ; 
; -- On input: ; 

; -- Client_AX : API id to execute. ; 

; -- Jump to corresponding API routine. : 

. ***************************************************** . 

movzx eax, [ebp].Client_AX ; Function number, 

cmp ax, cpfn ; Within range? 

ja short PMApiDone : No, so exit, 

jmp rgpfn[eax * 4] ; Yes, call handler. 

PMApiDone: 
ret 

EndProc PMApi 
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. ***************************************************** 

: -- Return the version number. 

. ***************************************************** 

BeginProc WGetVersion, Public 

mov [ebp].Client_AX. wVersion 
ret 

EndProc WGetVersion 

BeginProc RegisterLpfn. Public 
.***************************************************** 

; -- Register the client’s callback function. 

; -- Client_ES:Client_DI : Pointer to callback. 
.***************************************************** 


mov 

ax, [ebp].Client_ES 

: Selector. 

shl 

eax, 16 


mov 

ax. [ebp].Client_DI 

: Offset. 

mov 

[lpfnNotify], eax 


ret 

EndProc 

RegisterLpfn 



BeginProc CchRead. Public 

.***************************************************** 
; -- Read the bytes tee’d from the given VM. 

; -- On Entry: 

; - Client_DX:Client_BX : VM handle. 

: -- On Exit: 

: -- Client_DS:Client_SI : Output buffer. 

: -- Client_AX : # bytes copied. 

. ***************************************************** 


push 

es 

; Save stuff 

pushad 



mov 

[ebp].Client_AX, 0 

: Assume failure. 

mov 

bx, [ebp].Client_DX 

; Get VM handle. 

shl 

ebx, 16 


mov 

bx, [ebp].Client_BX 


VMMCall 

Validate_VM_Handle 

: Is it valid? 

jc short 

CchReadDone 

: No, so exit. 

call 

PcqsFindHvm 

: Get queue ptr. 

call 

CbCqs 

: # bytes to copy. 

mov 

[ebp].Client_AX. ax 

: Return # bytes. 

or 

eax, eax 

; Are there any? 

jz short 

CchReadDone 

: No, so exit. 

mov 

ecx. eax 

: Loop counter. 

mov 

es, [ebp].Client_DS 

: Get dest buffer. 

movzx 

edi, [ebp].Client_SI 

mov 

esi, ebx 

: Get head address 

add 

esi, size CQS 

; pcqs->rgb 

mov 

eax. [ebx].ibHead 


add 

esi. eax 

; + pcqs->ibHead. 

add 

eax. ecx 

: Get new head. 

call 

WMod 


mov 

[ebx].ibHead, eax 

: Record it. 

mov 

eax, ebx 

: Get source limit 

add 

eax, cbQueue + size 

CQS ; address. 

cld 


; Prepare to loop. 

CchReadDoLoop: 


cmp 

esi. eax 

: Wrapped? 

jl short 

CchReadNoWrap 

; No, we’re ok. 

mov 

esi. ebx 

; Yes, start over. 

add 

esi. size CQS 



CchReadNoWrap: 

movsb : Copy a byte. 
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Instead of blocking every time some DOS output is inter¬ 
cepted, the revised VxD behaves the same as the original 
version, unless the queue fills. This should help to mini¬ 
mize the number of times the DOS VM is blocked. 

The revised VxD blocks the DOS VM until the DLL and 
.exe running in the system VM have a chance to empty 


the queue. Thus the overflow flag is no longer required, 
and can be removed from the DLL's CchReadHvmO export 
(you can find revised source code for the DLL and .exe on 
the code disk). 

The changes in the new version of the VxD for semaphore 
blocking occur in the queue structure ( COS) and functions 


Listing 1 continued 

loop CchReadDoLoop ; Until no more. 

CchReadDone: ; If VM is blocked, wake it up. 

cmp [ebxl.fFull. 0 

je short CchReadOverflowChecked 
mov eax, [ebxl.hsem 

VMMCall Signal_Semaphore 
mov [ebxl.fFull, 0 

Cch ReadOverf1owChecked: 

popad ; Restore stuff. 

pop es 

ret 

EndProc CchRead 

BeginProc NotifyClient. Public 
.*****************************************************. 

; -- Schedule call back to system VM to call client’s ; 

; notification callback. ; 

; -- EAX : Notifcation code. ; 

; -- EBX : Queue. : 

.*****************************************************. 

pushad 

cmp [1pfnNotify]. 0 

jz short NotifyClientDone 

mov edx, [ebxl.hvm ; AX <-- code, hi 16 bits 

mov edx, [edx].CB_VMID 

shl edx, 16 ; gets VM id. 

or edx, eax 

VMMCall Get_Sys_VM_Handle ; Call sys VM. 
mov esi. offset32 DoNotify 

VMMCall Call_VM_Event 

NotifyClientDone: 
popad 
ret 

EndProc NotifyClient 

BeginProc DoNotify, Public 

.*****************************************************. 

; -- Post notifcation to client via callback. ; 

. *****************************************************. 

pushad 

Push_Client_State 

VMMCall Begin_Nest_Exec 

mov eax. edx ; Notification code. 


r 
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Listing 1 continued 

VMMCall 

Simulate_Push 




mov 

ebx. edx 

Get VM id. 

BeginProc PcqsFindVmi 


shr 

ebx, 16 


.*****************************************************. 

call 

PcqsFindVmi 

Get queue. 

: -- Find the circular queue for the given VM ID. ; 

cmp 

dx. nfcDataReady 


; -- EBX : VM ID on input, queue on output. : 

jnz short DoNotifyPushVmh 


: -- If found carry is clear, else 

carry is set. : 

mov 

[ebxJ.flnNotify, 

0 

.*****************************************************. 




mov eax, ebx 


DoNotifyPushVmh: 


VMMCall Get Sys VM Handle 

Start here. 

mov 

eax. [ebx].hvm 

VM handle. 



shr 

eax, 16 


PcqsFindVmiGetNext: 


VMMCall 

Simul ate_Push 

Hi 16 bits. 

VMMCall Get Next VM Handle 


mov 

eax, [ebx],hvm 

VM handle. 

VMMCall Test Sys VM Handle 

Back to first? 

VMMCall 

Simulate_Push 

Lo 16 bits. 

jz short PcqsFindVmiNotFound 


cmp 

dx, nfcVMDestroy 


cmp [ebx].CB VMID. eax 

Is this it? 

jnz short DoNotifyCal 


jnz short PcqsFindVmiGetNext 

Nope, try again. 




call PcqsFindHvm 

Yup, we're done. 

DoNotifyCall: 



clc 


mov 

cx. word ptr [1pfnNotify + 2] 

ret 


movzx 

edx. word ptr [1pfnNotify] 



VMMCall 

Simul ate_Far_Cal1 


PcqsFindVmiNotFound: 


VMMCall 

Resume_Exec 


stc 

Not found. 

VMMCall 

End Nest Exec 


ret 


Pop_Client_State 


EndProc PcqsFindVmi 


popad 



VxD Code Ends 


ret 



End 


EndProc DoNotify 


; End of File 



ZMInitO, VMEndO, Int21Hook(), and CchReadO. The COS now 
has an extra field for the semaphore handle, which is allo¬ 
cated inside VMInitO and released inside VMEndO. Also, the 


overflow flag in the COS has new semantics, and has been 
renamed to fFull, to indicate that the queue can hold no 
more characters. 

In addition to setting the full flag 
(when it has been determined there 
is insufficient space in the queue for 
the incoming characters), Int21Hook() 
calls Mait_Semaphore to block the DOS 
VM. The symmetric change has been 
made to CchReadO, which if it sees 
that the fEull flag has been set, calls 
Signal_Semaphore() to wake the sleep¬ 
ing VM. 

Just to make sure the changes 
work, I modified the .exe (teelist.exe) 
with a very simple menu. The menu 
appears on the per-VM popup win¬ 
dows, and has two items, Stop and 
Go. Selecting Stop clears a flag asso¬ 
ciated with the popup window, and 
selecting Go sets the flag. The popup 
window procedure calls the DLL to 
read the characters from the VM's 
queue only when the flag is set. So, 
with the flag clear, the VM will even¬ 
tually fill the queue and block (since 
the DLL will not be calling the VxD's 
CchReadO routine to empty the 
queue). If you try this, you will see 
that the DOS VM does indeed block. 
When I break into WDEB386, the . vl 
command reports that the VM status 
is 'Back' and 'Block'. □ 


SQL-Sombren) 


Sulmin 

'FAUSTi 


\X( ? r s i i c > r l 1 O 


for Windows 1 


Have you ever wanted to access your SQL Server" without resorting to using ODBC 
or any indirect layer tool? SQL-Sombrero for DB-Library ™ is your solution!!! 

SQL-Sombrero/VBX for Windows 
The Complete VBX DB-Library for SQL Server" 

SQL-Sombrero/VBX for DB-Library component will allow you 
to do just that. The SQL-Sombrero/VBX is a Visual Basic® 

Extension that provides the direct interface to use DB-Library 
functions without using C or C++. 

Direct access to the SYBASE®/Microsoft® DB-Library functions: 

SQL-Sombrero/VBX for DB-Library allows direct access to 
SYBASE/Microsoft DB-Library 
functions from any product that uses 
Visual Basic VBX files. 

Direct access to DB-Library from 
Visual Basic! In conjunction with 
Visual Basic you can have total 
control over accessing all Microsoft and 
SYBASE SQL Server and Gateways, 
including the SYBASE®/Micro Decisionware 
Inc. Database Gateways. 

It can also be used to replace the use of ODBC and VBSQL when 
using SQ L-$ombrero / VBX .Q_ r SQL - Sombrero /O LE 
for DB-Library- 

SQL-Sombrero/VBX for DB-Library 

• contains all of the DB-Library functionality 
(over 120 functions) 

• includes Windows' - on-line help 

• gives access to all DB-Library Bulk-Copy functions 

• works with Microsoft and SYBASE SQL Server 
(System 10 also) 



Sybase - 


Microsoft* 


SQL-Sombrero/OLE for Windows’" 

The Only OLE Automation DB-Library" for SQL Server 

SQL-Sombrero/OLE for DB-Library component will allow you to 
do just that. The SQL-Sombrero/OLE is an OLE Automation 
object that provides the direct interface to use DB-Library 
functions without using C or C++. 

Direct access to the SYBASE®/Microsoft® DB- 
Library functions: SQL-Sombrero/OLE for DB- 
Library allows direct access to SYBASE/ 
Microsoft DB-Library functions from any 
product that acts as an OLE container and 
has programming language that is capable 
of interacting with OLE Automation. 

Direct access to DB-Library from Excel-5D 
and other OLE containers!!! Microsoft Excel 
version 5.0 is an example of a product that can 
contain OLE object/component. In con-junction 
with Visual Basic® for Application (VBA) you 
can have total control over accessing all Microsoft and SYBASE 
SQL Server and Gateways, including the SYBASE®/Micro 
Decisionware Inc. Database Gateways. It can also be used with 
Visual Basic to replace the use of ODBC and VBSQL when using 
SQL-So mbr e r o/VBX or SQL Spmbrero/QLE fqr DB-Ubrary . 

SQL-Sombrero/OLE for DB-Library 

• contains all of the DB-Library functionality provided by 
a total of five (5) objects available within SQL 
Sombrero/OLE for DB-Library Automation component 

• gives access to all DB-Library Bulk-Copy functions 

• works with Microsoft and SYBASE SQL Server 
(System 10 also) 


To order or for more information, call: . 

PH: (819) 778-5045 (fax on demand avail.) 

RAX (81 9) 778-7943 
1-800-567-9127 
CompuServe: '71162,1050 

01992-1994 Sylvain Faust Inc. Other product names herein have been used for identification purposes only, and may be trademarks and /or registered trademarks of their respective companies. 
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New Products 

Industry-Related News & Announcements 


Nu-Mega Updates Debugging Tools 

Nu-Mega is shipping new versions of its line of 
BOUNDS-CHECKER and SOFT-ICE debugging tools for 
Windows. BOUNDS-CHECKER32/S vl .0 is a new version 
of BOUNDS-CHECKER for debugging Win32s programs. 
Soft-ICE/W vl .5 is a new version of Soft-ICE that supports 
both 16-bit Windows 3.1 and Win32s. 

BOUNDS-CHECKER v2.2 for Windows is the latest ver¬ 
sion of the product for 16-bit Windows. This version fea¬ 
tures support for Microsoft's Visual Basic custom controls 
(VBXs), automatically detecting memory and resource 
leakage and heap and data corruption in VBXs from C, 
C++, and Visual Basic. The product also validates the pa¬ 
rameters of calls to the VBX programming API. 

The NT version of BOUNDS-CHECKER, BOUNDS- 
CHECKER32/NT is finally shipping. In addition to the API 
validation and resource leakage checking that the 16-bit 


Vireo Ships Toolkit for VxD Developers 

Windows virtual device drivers (VxDs) are privileged 
modules that can give multiple DOS and Windows appli¬ 
cations the illusion that they have exclusive access to a 
single hardware resource, such as the system timer chip, 
or DMA module. VxDS also have access to the large Vir¬ 
tual Machine Manager (VMM) API that underlies Win¬ 
dows itself. The VMM (not directly accessible from 
ordinary Windows programs) offers services for schedul¬ 
ing, trapping hardware access, hooking interrupts, and 
other system-level tasks. Unfortunately, documentation 
on writing VxDS is scanty, and Microsoft's DDK for Win¬ 
dows does not provide direct support for writing VxDS in 
any language but assembly language. 

VtoolsD Is a toolkit designed to simplify VxD writing 
by providing support for writing VxDS in C. VtoolsD of¬ 
fers C and C++ interfaces to the large VMM API. It sup¬ 


Windows version provides, the NT version of BOUNDS- 
CHECKER can help detect multithreading bugs. The trace 
file provides an overview of the thread context switches 
after your program executes. 

Nu-Mega has also announced beta programs for 
BOUNDS-CHECKER ($249) and Soft-ICE/W ($386) for Win¬ 
dows 95. The price of the beta program includes updates 
and a copy of the final production version of the prod¬ 
ucts after Windows 95 ships. 

BOUNDS-CHECKER32/NT vl .0 for Windows NT costs 
$249. BOUNDS-CHECKER v2.2 for Windows costs $249. 
BOUNDS-CHECKER32/S vl .0 for Win32s costs $249. Soft- 
ICE/W vl .5 for Windows costs $386. For more informa¬ 
tion, contact Nu-Mega Technologies, Inc, P.O. Box 7780, 
Nashua, NH 03060-7780, (603) 889-2386; FAX (603) 
889-1135. 


plies 84 C runtime library functions, necessary because 
your normal C runtime library was not designed for use 
in the 32-bit, ring 0 environment that VxDS run in. The 
toolkit includes QuickVxD, a form-based utility that can 
automatically generate the skeleton of a VxD for you, 
creating a standard include file, code module, and make¬ 
file. You would then begin adding custom code to the 
generated files. 

VtoolsD for Windows 3.1 costs $495. It requires the 
Microsoft Windows DDK or VxD-Lite (from the MSDN CD- 
ROM). It also requires a 32-bit Microsoft C compiler 
(MSVC-32 for NT or Win32s version 1.0 or later). For 
more information, contact Vireo Software, Inc, 385 Long 
Hill Road, Bolton, MA 01740, (508) 779-8352; fax (508) 
779-8351; vireo@vireo.com. 


SQL Tools Support OLE Automation, OCXs, and VBXs 


Syivain Faust Inc., makers of SQL-Programmer for 
Windows, has a new line of development tools that sup¬ 
port Microsoft SQL Server and SYBASE SQL Server: the 
SQL-Sombrero suite of development tools. The OLE Auto¬ 
mation products (SQL-Sombrero/OLE2/DB-Library and 
SQL-Sombrero/OLE2/Client Library) allow access to the 
SYBASE DB-Library or Client Library functions from any 
application that acts as an OLE container. Other products 
in the line include SQL-Sombrero/VBX/DB-Library, SQL- 


Sombrero/VBX/Client Library, SQL-Sombrero/OLE Cus¬ 
tom Control/DB-Library, and SQL-Sombrero/OLE Custom 
Control/Client Library. 

SQL-Sombrero/OLE2/DB-Library and SQL-Som¬ 
brero/VBX/DB-Library each cost $249. For more informa¬ 
tion, contact Syivain Faust Inc, 880, boul. del la Carriere, 
Ste 120, Hull, Quebec Canada J8Y6T5, (800) 567-9127 
or (819) 778-5045;fax (819) 778-7943; 

71162.1050@compuserve.com; BBS (819) 778-8556. 
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DLL Provides PostScript Import and Viewing 

The Access Softek Plug-In EPS Vector Import Filter is a The Access Softek Plug-In EPS Vector Import Filter 

DLL that gives Windows developers a ready-to-use Post- DLL costs $4,995, or $25,000 with source code. For more 

Script interpreter. Developers can use the DLL to give information, contact Access Softek, 2550 9th Street, #206, 

their Windows applications the ability to import and Berkeley, CA 94710, (510) 848-0606; fax (510) 848- 

view EPS (Encapsulated PostScript) files. 0608; CompuServe 76702,776;ptuglns@sqftek.com. 


Image Library Now Reads Kodak Photo CD Formats 


Version 5.0 of AccuSoft's Image Format Library now 
provides the ability to read Kodak Photo CD image for¬ 
mats. This version includes a new color reduction ability, 
automatic thumbnails, and new compression algorithms. 
The library is available for Windows, DOS, NT, OS/2, 
Macintosh, and UNIX, and supports popular raster image 

FFT Library Moves to Windows 

Sigma Software has announced a Windows version 
of the G_FFT signal processing library. C_FFT for Win¬ 
dows is a high-speed, signal processing C++ class library. 
It includes real and complex Fast Fourier Transforms, 

I FFT, convolution, auto-correlation, cross-correlation, deci¬ 
mation, power spectrum, amplitude calculations, window- 


formats such as JPEG, TIFF, PCX, DIB, TGA, GIF, WMF, 

PICT, DCX, WPG, EPS, and BMP. 

The AccuSoft Image Format Library costs $495 for Vis¬ 
ual Basic and $795 for either Windows or DOS. For more 
information, contact AccuSoft, P.O. Box 1261, Westbor- 
ough, MA 01581, (508) 898-2770;fax (508) 898-9662. 


ing, tapering, data smoothing, and digital filtering rou¬ 
tines. 

The G_FFT for Windows costs $149, includes free 
technical support, and is royalty-free. For more informa¬ 
tion, contact Sigma Software, 15779 Columbia Pike, Suite 
360, Burtonsville, MD 20866, voice/fax (301) 549-3320. 


VBX Links Apps to Popular Word Processors 


DocLink/VB vl .0 for Windows is a new VBX that lets 
Windows developers integrate their applications with 
WordPerfect, Microsoft Word, or Lotus Ami Pro. A single 
API provides access to all three word processors, rather 
than requiring you to leam and write custom code for 
each. DocLink/VB works with any programming environ¬ 
ment that supports VBX custom controls, including Visual 
Basic v3.0, Visual C++ vl .5, Borland C++ v4.0, and 
dBASE V5.0. 

DocLink/VB provides access to the target word proc¬ 
essor via high-level merge, form editing, and macro func¬ 
tions. The control uses the word processor's merge 
engine from within the application. You can give fields 


any name and merge text with any external data. The 
number of records is unlimited and form files can be 
changed in the middle of a merge. When the user wants 
to edit a form, DocLink/VB can switch from the applica¬ 
tion to the target word processor. Field names can be 
passed from the word processor to the word processor's 
field selection list box, allowing field names to be placed 
on the form by pointing and clicking. 

DocLink/VB vl .0 for Windows costs $195 and is roy¬ 
alty-free. For more information, contact NAPERSOFT, Inc, 
40 Shuman Boulevard, Naperville, IL 60563-8466, (708) 
778-0080. 


Visual/Recital vl.O Provides RAD for DOS 

Visual/Recital vl .0 is a rapid applications develop¬ 
ment system for DOS that is Xbase compatible with Bor¬ 
land's dBase IV and dBase 5, Microsoft's FoxPro, and 
Computer Associates' Clipper. Visual/Recital helps you 
create character-mode DOS systems with windowed user 
interfaces. The product contains an integrated applica¬ 
tions data dictionary, dialog boxes, pulldown menus, 
pushbuttons, checkboxes, and RDBMS engine. Xbase ap- 


Embed JPEG Images with New SDK 

JPEG-SDK is a new SDK from MuTech Corp. for DOS 
or Windows developers who need to use image compres¬ 
sion in their applications. The SDK is compliant with ISO- 
10918 and supports both lossy (discrete cosine 
transform) and lossless (entropy Huffman coding) com¬ 
pression. A full-screen 640x480 24-bit color image can 
be compressed from 921 Kb to less than 50Kb. JPEG com¬ 
pression ratios of up to 100:1 are possible when image 
quality is not the primary concern. The package is opti¬ 
mized for the Intel 80x86; compressing or decompress¬ 
ing a full-color 320x240 image on a 486/33 processor 


plications are portable to all the platforms Recital sup¬ 
ports, including VAX/VMS, OpenVMS, HP MPE, and over 
70 UNIX platforms. 

Visual/Recital vl .0 costs $695 per copy. For more in¬ 
formation, contact Recital Corporation, 85 Constitution 
Lane, Danvers, MA 01923; (508) 750-1066;fax (508) 
750-8097. 


typically takes two seconds. The JPEG library also sup¬ 
ports MuTech's line of Image/VGA frame grabbers. 

The company also offers IGVJPEG, a Windows com¬ 
pression utility that lets users grab, compress, decom¬ 
press, file, and retrieve images using MuTech's VGA 
series frame grabbers. IGVJPEG costs $150. 

MuTech's JPEG-SDK costs $1,500 and includes 100 
runtime licenses. For more information, contact MtiTedi 
Corporation, 800 W. Cummings Park, Suite 3800, 

Wobum, MAO 1801, (617) 935-1770; fax (617) 935-3054. 
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Text Retrieval Package Cains Network Support, Fuzzy Searching 


DT Software, Inc. has released version 3.0 of its text 
retrieval software, dtSearch for DOS and dtSearch for 
Windows. dtSearch performs indexed, unindexed, and 
combination searches across multiple indexes, directo¬ 
ries, and drives. Search criteria include Boolean matches, 
proximity, phrase, wildcard, segment, and file name or 
date. 

This release features: a network server version; 
'fuzzy' searching, with 'fuzziness' adjustable from 0 to 
10; phonic searching, unlimited indexing capacity 
(dtSearch v2.0 can create an unlimited number of in¬ 
dexes, each holding up to 15,000 files of any length, and 
can search up to 25 indexes with a single search re¬ 
quest); faster indexing and searching (the Phar Lap DOS 
extender is used to improve performance for the DOS 
version); scrolling word lists; stemming; the ability to cre¬ 
ate hypertext-linked databases; tagging of multiple files 

C++ Library Offers Neural Networks 

Neural++ is a collection of neural networks packaged 
as a C++ library. Neural++ lets you explore the adaptive 
capabilities of neural networks within a DOS or Windows 
C++ framework. Neural++ contains neural networks: BP, 
CPN, Kohonen, and Outstar. Data scaling and Z-score 
data preprocessing is transparently automated. The pack¬ 
age includes a user's guide and C++ class programming 


to copy, print, or include in a search report; annotation 
of text to copy; expanded batch language and support 
for batch scripts under Windows; a DDE-based API for 
Windows; recognition of additional file formats (now sup¬ 
ports Microsoft Word v6.0, XyWrite, and DBF files); a 'fil¬ 
tered binary' option for extracting text from 
unrecognized or binary files; IBM 'Readyl for OS/2' certifi¬ 
cation for the Windows version. 

dtSearch v3.0 for DOS or Windows costs $149 for a 
single user or $650 for five LAN users. If you buy both 
DOS and Windows versions, the cost is $199 for a single 
user, or $800 for five LAN users. For more information, 
contact DT Software, Inc, 2101 Crystal Plaza Arcade, 

Suite 231, Arlington, VA 22202, (800) 483-4637. You can 
order through the software distributor ASC, at (800) 788- 
0787 or (314) 965-5630;fax (314) 966-1833. 


references. The C++ classes offer math capabilities and 
persistence via I/O streams. 

Neural++ costs $269, and includes Math++, a set of 
numerical classes that provide matrices, vectors, linear al¬ 
gebra, random numbers, regression, simulation, and 
data analysis. For more information, contact Advanced 
Computing Labs, P.O. Box 1547, West Chester, OH 45069, 
(513) 779-2716;fax (513) 779-4010. 


Datalight Offers Free Evaluation Kit for Intel386 EX Processors 


Datalight has configured a special version of its ROM- 
DOS SDK for the Intel386 EX embedded processor. It in¬ 
cludes a miniBIOS, ROM-DOS, and all the software 
needed to get a DOS application up and running out of 
flash memory on the Intel386 EX processor evaluation 
board. The kit is available free for evaluation, and is a 
subset of Datalight's full ROM-DOS SDK. An OEM license 
agreement is required to include the software with any 
product. 

The kit includes ROM-DOS 6 (an MS-DOS 6 equiva¬ 
lent operating system), Datalight's miniBIOS (a no-royalty 
minimal BIOS you can use with ROM-DOS to run an em¬ 


bedded system), and REMDISK (a remote disk utility that 
lets the EX board access a disk on a host PIC via a serial 
cable. The kit also includes a ROM Disk Builder that lets 
users load applications on the EX board: the ROM-DOS 
files can be transferred to flash memory on the board 
and ROM-DOS can be running within 15 minutes. 

The full ROM-DOS SDK costs $495 and licenses cost 
$2 to $25 depending on quantities. You can download 
the kit from Datalight's BBS at (206) 435-8734. For more 
information, contact Datalight, 307North Olympic Ave¬ 
nue, Suite 200, Arlington, WA 98223, (206) 435-8086 or 
(800) 221 -6630;fax (206) 435-0253. 


ImageFX Ships Professional Edition of FXTools/VB 


FXTools/VB Professional Edition is a multimedia spe¬ 
cial effects development tool that supports leading com¬ 
pressed image file formats and also integrates 
professional effects into movies without video editing. Im¬ 
age file formats supported include Iterated Systems Frac¬ 
tal Image File format (FIF), LEAD Technologies 
compressed format (CMP), and JPEG. The product pro¬ 
vides more than 100 special effects and supports image 
hot-spot detection. You can display text with seven 3D 


styles, 3D borders, and rotation, and you can apply spe¬ 
cial effects to AVI and QuickTime movie frames. The con¬ 
trol lets you play WAV and MIDI sound and synchronize 
effects using timing features build into each control. 

FXTools/VB Professional Edition for Visual Basic v3.0 
costs $349. For more information, contact ImageFX, 

3021 Brighton-Henrietta TL Road, Rochester, NY 14623, 
(716) 272-8030;fax (716) 272-1873. 


MainSoft Updates UNIX-hosted Windows API 


MainWin vl .1 is a new release of MainSoft's "Win¬ 
dows API on UNIX' that includes support for Windows 
code ported to the 32-blt Windows NT environment. 
Both 16-bit and 32-bit Windows APIs are supported by a 
single copy of MainWin vl .1, which is a shared library. 
The new version also includes DDEML support and per¬ 
formance enhancement. This version also supports 
many of the Win32s-speclfic API functions. 


The MainWin/CDK vl .1 costs $5,000 for the first 
copy, $3,500 for the second copy, and $2,000 for each 
additional copy. Runtime licenses cost $199 per worksta¬ 
tion user. For more Information, contact MainSoft 1270 
Oakmead Parkway, Suite 310, Sunnyvale, CA 94086, 
(408) 774-3400;fax (408) 774-3404. 
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DBS Updates Image Processing Kit and Text Control 


TX Text-Control for Visual Basic is a custom control 
that lets developers add word processing features (WYSI¬ 
WYG text display, editing, and printing) to their applica¬ 
tions. Users can emphasize text with underline or 
boldface, select font colors, set justification/indent/spac¬ 
ing separately for each paragraph, format tables with 
four different tabulator types, exchange formatted text 
via the clipboard, and import and export RTF. The con¬ 
trol supports documents larger than 64Kb. A zoom fea¬ 
ture offers six scaling factors between 30% and 400%. 

Ad Oculos v2.0 is the latest version of an SDK for digi¬ 
tal image processing under Windows. The new version 
features a counting and measuring system, improved file 
import/export, and a better user interface. The software 
includes C source code for all the image processing algo¬ 
rithms (more than 100) the product uses. You can use Ad 
Oculos to process images, using a variety of global and 


local operators, region and contour segmentation, 
Fourier and Hough transforms, morphology image proc¬ 
essing, pattern recognition, and image sequence analy¬ 
sis. All the algorithms are delivered as DLLs. A free demo 
is available in file aodemo.zip in the public utilities section 
of the WINSDK forum on CompuServe. 

TX Text-Control costs $249. Ad Oculos costs $470; 
the book and demonstration software costs $49, refund¬ 
able if you purchase the complete package. For more in¬ 
formation, contact ton Campbell, DBS GmbH, 
Kohlhoeherstrasse 61,28203 Bremen, Germany, ++49- 
421-3359 1 0 or ++49421 -73306; FAX ++49-42 1 - 
3398658; CompuServe J 00013,115. In North and South 
America, contact European Software Connection, P.O. Box 
1982, Lawrence; KS 66044, (913) 832-2070;fax (913) 
832-8787; 71141.3624@compuserve.com. 


Thunder Island Offers Bar Codes for Windows/DOS 


Thunder Bars for Windows is a set of functions 
(source code included) that generates scalable bar codes, 
patch codes, and postal codes. Your application can use 
these routines to generate codes to the clipboard, which 
can be pasted into any program that can insert graphics 
from the clipboard. The library provides font selection, 
online help, and DDE support, and requires no prior 
knowledge of bar codes. An included library provides the 
same services for Visual Basic programs. 

TrueBarXDOS is a C programmer's utility for DOS that 
generates printer control codes to produce bar codes. 
The product includes source code and a command-line 
interface for non-programmers. TrueBarWBX is a Win¬ 
dows custom control that generates device-independent 


bar codes. Most bar code options and features can be im¬ 
plemented without writing code, by setting various con¬ 
trol properties at design time or runtime. Windows 
Printer Drivers are standard Windows drivers that pro¬ 
vide custom support for specialty label and bar-code ther¬ 
mal/thermal transfer printers. Printers supported include 
Fargo, Fargo/Datamax, Sato, Zebra, Intermec, Printronix, 
OTC, DHTechnology, Cognitive Solutions, and Eltron. 

Thunder Bars for Windows costs $199. TrueBarXDOS 
costs $149. TrueBarWBX costs $289. Windows Printer 
Drivers costs $149. For more information, contact Thun¬ 
der Island, Inc, P.O. Box 1034, Eau Claire, Wl 54702, 

(800) 336-1166 (sales) or (715) 835-8091 (support); fax 
(715) 835-5468; BBS (715) 835-4733. 


Subpanes/V v2.1 Features Improved Table Pane 


Subpanes/V v2.1 is a collection of user interface con¬ 
trols for use in WindowBuilder Pro/V, a tool that lets 
Smalltalk/V programmers build user interfaces interac¬ 
tively. This version features drag-and-drop support and a 
table pane that supports collections of objects. All the 
controls provided in Subpanes/V are subclasses of CPSub- 
Pane. They support drag and drop, and users can drag 
and drop complete objects. Subclasses of Digitalk's Sub- 


Blinker 3.0 Available in Four Languages 

Blinker 3.0 is a royalty-free DOS extender, Windows 
linker, and DOS dynamic overlay linker. You can use it to 
create a program that will automatically run in both real 
and protected mode. This version features foreign lan¬ 
guage versions of the product for German, Spanish, and 
Chinese, each of which includes a 500+-page translated 
technical reference manual and Norton Guide help file. 

In addition, Blinkinc will put interested programmers in 
touch with Blinker distributors around the world, ena¬ 


Pane hierarchy are modified to support dropping string 
representations. Subpanes/V includes complete Small¬ 
talk/V source code, and is royalty-free. 

Subpanes/V v2.1 for V/Windows, V/Win32, or 
V/OS/2 each cost $235. For more information, contact 
Objectshare Systems, Inc, 5 Town B Country Village, Suite 
735, San Jose, CA 95128-2026, (408) 727-3742;fax 
(408) 727-6324; 76436.1063@compuserve.com. 


bling programmers to obtain technical support in a vari¬ 
ety of languages. 

Blinker v3.0 costs $299. The DOS extender requires a 
minimum of an 80286 to run protected-mode programs; 
the extender is compatible with DPMI, VCPI, and XMS 
specifications, so the DOS-extended program will run un¬ 
der Windows, OS/2, and DOS. For more information, con¬ 
tact Blinkinc 8001 West Broad Street Richmond, VA 
23294, (804) 747-3600 (support) or (804) 747-6700 
(sales);fax (804) 747-4200; BBS (804) 747-7333. 
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Readers' Forum 


From: Steve Valliere, svalli@bix.com 
Subject: MSVCNT Bug 

Ron, 

I submitted this bug to MS via CIS 
about two weeks ago and thought 
you might be interested in it. It isn't 
quite an NT bug, but at least it is a 
bug in MS's NT C compiler (MSVCNT 
1.0, on Windows NT 3.1, Build 528, 
Service Pack 2). The bug is that this 
expression: 

L0BYTE(HIW0RD(1 Param)) 

doesn't always work. The resulting 
value appears to depend on the size 
of the storage location, rather than 
the macro's operation. Microsoft's 
header defines the LOBYTE macro as 
follows: 

#def1ne LOBYTE(X) ((BYTE)(X)) 

The ANSI standard says that when 
casting X from an M-bit unsigned in¬ 
teger to an N-bit unsigned integer 
(where N < M), the result should be X 
modulo 2 to the Nth power. So, 
when casting X to a BYTE, the result 
should be X % 256. At times how¬ 
ever, a BYTE cast (or an unsigned 
char cast, which should be the same) 
will result in the original 16-bit value, 
rather than the 8-bit value which is 
expected. (I was trying to allocate 
0xB703 K bytes for a buffer instead 
of 3K because of this!) It appears that 
the compiler disregards the BYTE cast 
when it is combined with other op¬ 
erations in a single statement and 
the destination is not a BYTE. 

In any event, we've redefined the 
LOBYTE and LOWORD macros as 

tfdeflne LOBYTE(X) ((BYTE)((X)&0x0FF)) 

#def1ne LOWORD(X) ((WORD)((X)&0x0FFFF)) 

Probably less efficient than a cast 
should be, but they work OK (and 
correctly) for us, even when com¬ 
bined with other macros. 

Here's the bottom line on the bug: 
Given 

LPARAM d, hw, lb; 

BYTE byVar; 


d = 0x12345678; 

Then 

hw = HIWORD(d); 

will generate 

mov eax.dword ptr [d] 
shr eax,10 
and eax,0000ffff 
mov dword ptr [hw],eax 

and 

lb = LOBYTE(HIWORD(d)); 

will generate 

mov eax.dword ptr [d] 
shr eax,10 
and eax,0000ffff 
mov dword ptr [lbLeax 

Also 

byVar = LOBYTE(HIWORD(d)); 

will end up with the correct value. Of 
course, there's no way that it could 
contain both bytes anyway, but the 
compiler will generate a byte move 
this time. 

Unfortunately, I don't have easy ac¬ 
cess to a system running Windows NT 
(although if Pentium prices keep drop¬ 
ping, I will within a few months). How¬ 
ever, Paula Tomlinson tried out your ex¬ 
ample on her Windows NT system and it 
is clearly unexpected behavior, or a bug 
by any other name. Maybe next year 
Windows NT will achieve critical mass 
among our readers and we will start 
regular bug coverage of NT and related 
tools. On the other hand, once Windows 
95 ships, maybe the tools for NT and 
Windows will be pretty much the same, 
so Mark Nelson's Bug- h - column can 
cover everything! -rib 


From: Kelly Ingerson 
<0006958491 @mcimail.com> 

To: wdletter@rdpub.com 
Subject: Bug++ 

I recently sent the following infor¬ 
mation to both the Borland and Wat- 
com Technical Support groups and, 


for the first time, cannot seem to get 
a response out of either of them. 

The example in Listing 1 produces 
a bug when compiled with both the 
Borland C++ 4.02 and Watcom C++ 
10.0a compilers. Please note the 
statement '... initO.NumO;' which is 


Listing 1 Kelly Ingerson’s 
buggy code 


include <stdio.h> 

class Base { 

static int num: 

public: 

Base Jlnltdnt num=0) 

{ 

pr1ntf("Init()\n">: 
th1s->num = num; 
return (*th1s): 

) 

static Int NumO 
{ 

printf("Num()=%d\n", num); 
return (num); 

1 

void Funcdnt num=8) 

( 

printf("Base::Func()\n"); 
Inlt(num).Num(); 

} 

}; 

Int Base::num = 8; 


class Derive : public Base { 
public: 

void Funcdnt num=8) 

{ 

printf("Derive::Func( )\n"); 
Inlt(num).Num(): 

) 

): 


Int malnO 
{ 

Derive derive: 

Base base; 

printfCV** base. Fund 1 )=>In11<).Nun() ***\n"); 
base.Func(l); 

pr1ntf(”\n*** base.In1t(2).NumO ***\n"); 
base.Init(2).NumO; 

pr1ntf("\n*** derlve.Fmc(3)=>In11().Nun() ***\n"); 
derive.Func(3); 

printf("\n*** derive.In1t(4).Num() ***\n"); 
derive. In1t(4). NumO; 

return (8); 

1 
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found in the mainO function and in 
the FuncO member functions located 
in the Base and Derive classes below. 
The problem is that the InitO member 
function is not invoked prior to call¬ 
ing the NumO member function. The 
output below should show an incre¬ 
mental increase in NumO's values (1, 
2, 3, 4), but since InitO is not invoked, 
the result is always zero (0). 

It appears that the problem occurs 
when NumO is a 'static" member 
function, or at least the problem goes 
away when it is 'non-static'. I have 
tried several different variations on 
the code, and the problem does not 
appear to be tied to anything else. 

Although the workaround is to 
simply invoke the functions sepa¬ 


rately, the fact that the code compiles 
cleanly and issues no warnings can 
make determining the problems it 
produces quite difficult. 

When I sent this bug in 3 weeks 
ago, neither company even re¬ 
sponded. 

Kelly Ingerson 

Your code had me totally stumped. 
All four of my compilers (Watcom, Bor¬ 
land, Microsoft, and Symantec) produced 
the output you described. The odds of all 
four implementing exactly the same bug 
seemed rather low, so I decided I must be 
missing something. 

First, I stripped your code down to the 
smallest example possible. Then I de¬ 
cided maybe there was some conflict 


with some symbol in stdio.h that I didn't 
understand, so I added an "x" to every 
identifier in the code; I got the same re¬ 
sults. Next, I disassembled the code gen¬ 
erated. This showed that every time I 
wrote: 

base. Init(l). NumO; 

the compiler only generated code like 
this: 

call Base::Num() 

Now why would it refuse to generate code 
for the left half of that expression? Of 
course, it is a little odd to use the opera¬ 
tor to refer to a static member. Typically, 
you would write something like 

(continued on page 86) 
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Marketplace 


C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, ’C statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional f$2991 DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
ONT, Canada Voice/Fax f905V 
L5N-4M1 Demo/BBS (90 
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DICE IS LOOKING FOR, 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 



Data processing 

I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 


ONLINE Number 
515 - 280-3423 


Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
515-280-1144 


D Request Reader Service #152 □ 


Developer Jobs! 

1-800-231-5920 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
Specialists in R&D jobs for software engi¬ 
neers, SQA, product managers, etc. 
Nationwide contacts with both large and small 
companies including equity start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT, Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resume or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 

Internet: lej@scientific.com 

CompuServe: 71250,3001, AOL: davesmall 
SPI8, Box 19949, Houston, TX 77224 
(713) 496-6100 Fax: (713) 496-0373 
SPI8, Box 71, San Ramon, CA 94583 
(510) 733-6168, Internet: bge@spi.com 
SPI8, Box 4270, Johnson City, TN 37602 
V (615) 854-9444 Fax: (615) 854-9454 
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SOURCE CD ROM's 

LANGUAGE/OS 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for 
computer languages and OS on CD.... 
$34.95 (updated) _ 

LANGUAGE/OS II 

LARGEST collection of Source just 
got bigger!! A perfect companion to 
Language/OS, with more source for 
compilers, function libraries, and docs 
for standard and research 
languages & OS .... $34,95 

*****Buy both for only $64.95***** 
KNOWLEDGE MEDIA Inc. 

(800) 78 CD ROM (916) 872-7487/FAX (916) 872-3826 
VISA and MASTER CARD accepted 
436-B Nunneley, Paradise, CA 95969 USA 

□ Request Reader Service #289 □ 



OSETUP 


Windows Application 
Installation Tool 

"Create installations in minutes..." 

custom diiplav/BMP-prompts-readme dialog 
decompression-multiple disks-huge files 
version & time/date checking-font installation 
Program Manager group/icon creation 
Registration Database access-INI write/create 



Call or write for more info: 


Celtech Software 

16900 Crenshaw Blvd. #16 As 

Torrance. CA 90504 I 

310.769.1885 

info@celsoft.com •* 
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□ Request Reader Service #240 □ 


Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts Multimedia Wave (16, 8 & 

and save time with VFEdit ®! MS ADPCM), linear 16 & 
Record, crop, cut, copy, paste, unsigned 8, plus Dialogic 4 & 
mix, fade, echo, volume & 8 at any sample rate! 

more with your Dialogic™ 4. Scribe Transcription 
D4x/12x boards, utility for DOS plays digital 

2. Add Voice Mail power to audio files in the background 

your MS Windows apps with without voice mail hardware! 
TI/F DLL ™ our Tel I/F 5. A dd Text-to-Speech 
Dynamic Link Library. capability to your apps with 

3. Audio Tool Box™ VoxFonts ™, our "software 

converts to and from only" text-to-speech library! 


Order Now! 1-800-234-VISI 


1 Voice Information Systems: 24 N Mcrion Ave, Bryn Mawr. Pa 19010 I 

Tel:215-747-5035/ BBS310-392-6610/ Fax: 1-800-234-FXIT 

□ Request Reader Service #180 □ 


Unique Custom Controls 

We've got the controls everyone else 
missed. Whybuyyetanotherpackage 
with a bound text box when you can 
get more? 

Our controls are easy-to-use, solid, 
and royalty-free. Free lifetime updates 
from our BBS. Source code and site 
licenses are available upon request. 

There are too many to mention here, 
so write, call, or fax us for a product 
list. Or, send us $5 for a sample disk. 

Mabry Software 

Post Office Box 31926 
Seattle, WA 98103-6925 

Voice: 206-634-1443 
Fax: 206-632-0272 
CompuServe: 71231,2066 
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Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

WVT^IpV POBox5700 
L7 J Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 

□ Request Fax #1087 □ 



tTfJTT°TiVPR 


■om Walnut Creek CDROM 

All of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs-quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 
w/GNU & XI1. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/ GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

•shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1 -800-786-990711= ■!■- 

1-510-674-0783 • FAX 1-510-674-0821 

email: orders@cdrom.com 

4Q41 Pike lane, Suite D-691 Concord, CA 94520 
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Opt-Tech Sort/Merge 


^ New -Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

x (702) 588-3737 > 


□ Request Reader Service #322 □ 


Make $100,000+ 

Every Year Developing Low Risk 
Software Products! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


Call TOLL-FREE 800-364-4883 


Call TODAY for FREE recorded information 
and a FREE special report! 

ULTRA _ Fax: 214-724-1043 

Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr. Flower Mound, TX 75028 

□ Request Reader Service #259 □ 


Development 

Utilities 


World’s largest/best indexed collections of techni¬ 
cal shareware extensively indexed and updated six 
times a year on CD-ROM or diskettes. 30 day 
guarantee. Creditcards. Ship/H $5US, $15Foreign. 

Products MB/Files Price 

Access 

36/443 

$59.50 

Assembler 

21/552 

$59.50 

AutoCAD 

43/1206 

$59.50 

C (Turbo & MS) 

143/1686 

$149.00 

C++ (subset of above) 

85/820 

$99.50 

Clipper 

105/2978 

$149.00 

FoxPRO/dBASE 

83/1981 

$99.00 

Turbo Pascal 

53/1080 

$79.50 

Paradox 

38/859 

$59.50 

Visual BASIC 

62/908 

$79.50 

Sci/Engineering 

69/427 

$59.50 

Netware 

249/1748 

$195.00 

PC Products Database 

185,000 records $25.00 

TrueType Fonts 

15/752 

$59.50 

Windows Utilities 

115/998 

$129.50 


Any/All of above on 2 CD-ROMs S59.50/S195 

EMS Professional Shareware 
4505 Buckhurst Ct.; Olney, MD 20832 
(301) 924-3594, Fax: (301) 963-2708 


□ Request Reader Service #112 □ 


“I wish this was a 
Windows Application” 

You need the power and simplicity of 
ClearWin+™ with Salford’s 32-bit C++ 
compiler for DOS, Windows 3.x and 
Win32 (Windows NT and Chicago). 
Using formats, ClearWin+™ offers an 
innovative approach to the problem of 
producing maintainable Windows code. 
Write a realistic prototype quickly in less 
than 100 lines of code with no previous 
Windows programming experience! 


Salford 

(So/i-uriic 



ASK FOR A FREE 
DEMO DISK 
TODAY 


Adelphi House, Adelphi Street, Salford M3 6EN, UK 
Tel: (+44) 0161 834 2454 Fax: (+44) 0161 834 2148 
Fax toll free from USA: 1 800 562 6875 
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Base::Num(); 

when Num() is a static member function, 
rather than 

Base base; 
base.NumO; 

Because it is a static member function, no 
this pointer is implicitly passed to it, so 
the expression in front of the essen¬ 
tially serves to identify which class's 
Num() function is being invoked. I started 
leafing through my Stroustrup texts look¬ 
ing for any peculiarities involved in ac¬ 
cessing static member functions. Paydirt! 
Page 180 of The Annotated C++ Ref¬ 
erence Manual says: 


When a static member is accessed 
through a member access operator, the 
expression on the left side of the . or -> 
is not evaluated. 


I must confess that the reason the lan¬ 
guage was designed to work this way is 
beyond the grasp of my tiny brain, and I 
did not immediately find any comments by 
Stroustrup that shed light on this. One of 
the things I like least about C++ is that it 
has far more dark comers like this than C 
does. Although I don't think it is informa¬ 
tive for this particular case, I recommend 
reading Stroustrup's The Design and 
Evolution of C++ if you are the desig¬ 
nated C++ expert in your group. I have 
found it quite helpful in understanding 
(and remembering) why many parts of the 
language came to be as they are. 


I'm not sure what's going on with 
Borland and Watcom’s technical support 
I would hazard a guess that Borland has 
all hands on deck right now (November 
1994) as they try to ship a new version 
of the compiler. Perhaps their support 
will improve after that product ships. On 
the other hand, I have the impression 
that the quality of non-paid support for 
all PC C++ compilers has been on a gen¬ 
eral downward trend, -rib 


Sb: Book (in Brief) 

Fm: Jim Lawless [74217,531] 

Mr. Burk, 

I just wanted to inform you of a 
book that I am very impressed with. 
The book is titled Tricks of the Came 
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Dr. DeeBee™ 
ODBC Tools 

Tools for ODBC development 

Ever wonder why your 
ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

? Use Dr - DeeBee Tools 
- to find out. 

Dr. DeeBee utilities (Check, Peek, Timer, Test, Spy, 
Replay and Info) reveal the inner workings of ODBC. 

Dr. DeeBee: The smart nay to do ODBC. 

RO. Box 91 Kendall, Cambridge, MA 02142 

617 - 497-1376 
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Write Once, Help Many ! 


HLPDK/PA 



The Cross-Platform Hypertext / Hypermedia 
Help Development Kit 

Write your help source once on your favorite text^editor or with 
our sophisticated Windows based help editor, and generate help 
databases for Windows, OS/2, DOS, HTML (UNIX, Mac), 
MS Multimedia Viewer, RTF and text documents with ease. 
Use existing text documents to create complex hypermedia 
databases. Convert Windows help projects to other platforms. 
Add graphics, sound and many more powerful features 
to your help documents. 

Save 50% off list price! 

Get alt these and much more for only $149! 

Offer ends December 31,1994. List price is $299. 

...sstii: Call today for your copy of HLPDK/PA 

tj . and get NewsDB - Internet News Hypertext 
t t\pCl. Vkf Database generator for free ($40 value). 


P.O.Box 5517. Coralville. IA 52241. USA. 
TeleFax. (319) 351-8413. CompuServe 76350.333 
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GIF & Spelling 

Source Code/DLL's 


EET MGSPELL $9<T= 

Add a 120,000 word spell checker to your 
program. Includes suggestions, user 
dictionaries and full source code. With both 
.LIB files(for your DOS C C++ only), and 
Windows DLL(any DLL callable language, 
such as C.C++, Vis.Basic etc). Item 11359 

=Z VIEW-GIF $50^= 

Add full-color GIF displaying/importing to 
your DOS program. Uses only Borland C 
BGI calls. Includes FULL source code. 
Includes super-vga BGI driver. Item 11450 

Order through PSL 1-800-242-4775, 

PSL cannot provide product info. Please 
specify item number when ordering. 

For product info call 31+638-2506 
MicroGenesis P.O. Box 25534 St. Louis, MO 63125 
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DDE Manager 

For Visual C++™! 


Complete Dynamic Data Exchange 
capability for Visual C++! Our 
CDdeManager class suports 
simultaneous client/sever DDE 
transactions using DDEML for native 
data types, char or byte data, CString, 
and CObject-derived classes. No need 
to learn DDE, we’ve done all the work 
for you. Well commented source code 
on disk, examples and manual only $149 
(plus shipping and handling). 


/V 


Cone* pt s 
Ineor porat ad 


Complete Source Code 
Step by Step Simplicity 
No Royalties 


Resource Concepts, Inc. 
111 W. First Street, Suite 748 
Dayton, Ohio 45402-1106 

Tech"(513) 461 -4606 Orders: 1-800-434-1755 

□ Request Reader Service #324 □ 


Our copy protection works. 


<" // % / + 

^ owe 


Distributors 

protection 

J*“ welcome 


Softwirr Protection Device* 




Anywhere. 

At very reasonable price. 


Intar produces a wide range of 
copy protection devices. Our 
modules are designed to work 
in electrically and mechanically 
demanding environments and 
that Is why they are widely used 
in Finnish Industry, (e.g. CNC 
servers, PC Supervisor 
programs etc.) 



\ Printed circuit board 
Integrated circuit 
Epoxy Resin 


INTAR Oy, P.O. Box 70, FIN - 00511 Helsinki, FINLAND 
Tel: +358 - 0 - 148 4381, Fax: +358 - 0 ■ 148 4382 
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Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 
See for yourself. Download your 
unlimited eval copy. 

Try a complete, free eval copy tonight! 

Our BBS: 206-935-5198 
NET: ftp.halcyon.com /local/wilson 
CompuServe: WINAPA, Sec. 15 
AOL: WindowWare 
Direct: 1-800-762-8383 
Wi/son WindowWare, inc. 
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SmartHeap is an ANSI portable maflnc 
and new for DOS, Windows, NT, OS/2, 
UNIX and other platforms. Proprietary 
algorithms deliver speed improvements 
up to 100X versus other commercial 
mallocs, especially for large heaps in the 
presence of virtual memory. SmartHeap 
localizes data structures in their own 
heaps. Plus it includes numerous fixed- 
size and handle-based APIs. Debugging 
facilities isolate leakage, overwrites, 
double-freeing, wild pointers, and many 
other errors to responsible file/line/pass 
count. Exceptionally reliable - used by 
a "who’s who" of commercial software 
publishers. No royalties. Source avail¬ 
able. 

CALL FOR FREE 

WHITE PAPER, BENCHMARKS, 
AND ERROR REPORTS 

MicroQuiU 

Software Publishing, Inc. 

800-441-7822 / 206-525-8218 
FAX 206-525-8309 

CompuServe: 70751,2443 
Internet: devtools@microquill.win.net 


IMWHelp 


Window/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


fDynaZIP 

I Data Compression Toolkits 


The ROYALTY-FREE DynaZIP family of 
developer's tools let you read, test, 
create, write, and update industry 
standard ZIP files directly from your 
Windows-based products. No more 
“shelling" to DOS, and no more fussing 
with proprietary compression formats. 
Fast, easy to use, and totally reliable! 
Versions for C/C + + , Pascal, VB, 
database, 16 and 32 bit. 


Fully Supported, 
w/30-day no-risk guarontee! 
Call today, toll free: [800] 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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WINDOWS DEVELOPERS! 


Text-to-Speech 
Speech Recognition 
Speech Compression 


Software Development Kits 
now available for Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


LERNOUT & HAUSPIE 


PRODUCTS 


ISPEECH | 


800 W. Cummings Park, Suite 3100, Woburn, MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 

CALL FOR MORE INFORMATION 
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Spend your time writing your App 
...Not wading through 
DDK documentation!! 

Hardware control for Win32™Apps 
-without the Device Driver Kit 
✓ Port I/O 

✓ Memory I/O 
✓ Interrupts 

Ask us about Alpha™, Power PC™ and 
Chicago versions. 

Blue Water Systems 
(206)771-3610 
(206) 771-2742 FAX 

73514.132 @compuserve.com 
NT version $595 
Royalty free runtime 
Visa, MC, Approved PO I 
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The PC RS-232 Analyzer 

SI_SC0PE a comprehensive serial 
data scope enables users to examine 
activity on anyserial lineatbaud 
rates up to 115k. Capture data to RAM 
and disk while viewing activityin 
selectable data formats including 
ASCII and EBCDIC. Pattern searching, 
microsecond timestamp accuracy, 
keyboard intervention, macros, and 
more! 

- Manual and Cable Included. 

- 30 Day Money Back Guarantee 

"Easy to use and a great tool!" 

- M. Hicks . Clement Industries. 

For Orders/Info Contact: 

Software Innovations Inc. 

63 Rock Cut Rd. 

Newburgh, NY 12550 
(914) 567-0805 
CompuServe 75013,3310 
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S/W ENGINEERING POSITIONS NATIONWIDE 


We Understand 
Programmer's 
Mind . 31 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


It Bateman Inc. 
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Bar Code Fonts 


If you write enough applications, 
sooner or later you’re going to have 
to print bar codes. And what could 
be easier than calling a font? 

Azalea Software, Inc. specializes in 
quality bar code printing tools. Call 
us today to see how much fun bar 
codes can be. 



software inc 


Azalea Software, Inc. 
800 48 -ASOFT 
2 06 952.4030 
azalea@igc.org 
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Programming Gurus, by Andre 
LaMothe, John Ratcliff, Denise Tyler, 
and Mark Seminatore ($45.00, Sams 
Publishing, ISBN 0-672-30507-0). 

As the title says, the book is about 
video game development for the 
DOS-based PC. While the book may 
sound like a frivolous purchase for us 
game-programmer-wannabe's, I be¬ 
lieve it to be a very sound invest¬ 
ment for DOS programmers. 

The 700+-page book (with CD) 
manages to cover the following topics: 

• 80x86 architecture 

• 8086 assembly language (intro¬ 
duction) 

• Low-level hardware manipulation 
for accessing the VGA card, the joys¬ 
tick, the keyboard, and the mouse. 


Sound Blaster usage 
MIDI 

Interrupt Driven Serial I/O 
Interrupt-driven timer routines 
Video concepts such as 2D and 
3D sprites, line/point/polygon 
drawing, scaling, rotation, collision 
detection, vertical sync timing, ray 
tracing, ray casting (and too much 
more to talk about) 

PCX file processing 
Game-related machine intelligence 
algorithms and data structures in¬ 
cluding 'chase' algorithms, finite- 
state machines, pre-emptive proc¬ 
esses, probability machines, search 
algorithms, and many uses of 
data structures to model the 
'game' universe. 


This book contains some very 
useful system-level information for 
the DOS programmer. The material is 
presented in a very friendly, light¬ 
hearted manner. 

All of the C/ASM source code is 
provided on the CD. The CD also 
contains other game development 
tools and several shareware games. 

Check it out... I think you'll like it! 

Jim Lawless 

I do not remember seeing that book 
before, so I will shuffle on down to the 
bookstore and give it a look-see. Thanks 
for the recommendation! -rib □ 


Prepare for the Lotus Notes 
Certification Tests. 


Lotus Development and Drake 
International charge $270-$450 to 
get certified on Lotus Notes. Isn’t 
it worth $45-$60 to prepare? 


Consultant, 
Application Developer, 
Server Administrator PreTests 
(over 480 questions) 
cost just $45 each 
or buy the Specialist PreTest 
(over 720 questions) for just $60. 

These Lotus Notes databases allow 
you to take and grade the Pre Tests as 
many times as you want or need to. 


Send check or money order to: 

Reality Bytes 

28 South Main Street 
Randolph, MA 02368 
(Please share this ad with a friend.) 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 
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C and C++ 

'==- BROWSING 
FOR ANY EDITOR! 
Source Code Analysis and Documentation 


CC-RIOtR C*» Source Code Browser |MfCSRC.CC| 


file £dH view Sesrch Yflndow Iools Options Qel] 



. a 


NEW v5 for WINDOWS, DOS & OS/2 

Western Wares 

Free Demo (303) 327-4898 
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WinRcz 
Windows Mac Resource Handler 

Use yorrr existing Mac resources in Windows! 

Library routines written for all Mac resource¬ 
handling procedures and more! Port yottr apps 
with a minimum of re-writing! 

ResEdit-like tool allows for croalion/cditting of 
Mac resource forks in Windows. C Libraries for 
Winl6, Win32s, WinNT, OS/2, LIB/.DLL 
fonnats. 

I’arliuin Inc. 

86 Gerrard Street East, Ste. 14D 
Toronto, Ontario 
Canada MSB 2J1 

Voice: 416-598-9717 Fax: 416-598-8906 
email: winrez@partium.com 
WWW: hitp://w ww.inierlog.com/~winrez/winrez. htmi 
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COMPUTER SYSTEMSDEVELOPMENT.INC 


A respected computer consulting firm, ser¬ 
vicing clients in New York, New Jersey, and 
Pennsylvania, offers outstanding opportu¬ 
nities for experienced professionals. CSD 
is recognized by BUSINESS WEEK as one 
of the fastst growing high-tech companies. 
We have a proud history of growth and suc¬ 
cess and will continue our tradition by add¬ 
ing only the best and brightest people to 
our organization. We are currently seeking: 


E PROGRAMMER/ANALYSTS 


| With experience in the following: 

VISUAL/BORLAND/MICROSOFT 
C/C++, VISUAL BASIC 
WINDOWS / SDK 

| If interested, please contact: Bridgitt Lincoln | 

C.S.D. Software 

242 Old New Brunswick Rd 
Piscataway, New Jersey 088541 
I Phone: 800-882-8805 fax: 908-562-0102 f 
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I "Quality and Innovative! 
Presentation Graphics™ 

GigdSoft™ 

ProEssentiate™ vTI .5 

Turn-Key graphic presentation ideal for 
information and quality control systems. 
Windows 3.1 DLL + VBXs. Absolutely the 
best images in the industry. Nine built-in 
dialogs, popup menus, scrolling / random 
subsets and points, maximization, help, 
hot-spots, dual Y axis, and the smoothest 
scrolling via images prepared in memory. 
Export metafiles, bitmaps, and text to 
clipboard, file, and printer. Spawns OLE 
Objects. You must see to appreciate. 

CALL FOR A FREE DEMO ! 

Gigasoft, Inc. M, 

Phone: (817) 431-8470 
Fax: (817) 431-9860 'll 
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"Add support for 36 raster file formats instantly!" 

AccuSoft Image Format Library 

Import - Export - Scanning - Conversion - Compression 
Printing - Display - Image Processing - Special Effects Version 


New 

5 


AccuSoft has done it again! You asked for more formats: we 
added 24 new formats. You asked for more speed: we made it 
faster. You wanted advanced color reduction: we added a superb 
new color reduction technology. You wanted thumbnails: we 
added them. You asked for it, you got it. Version 5! 

Guaranteed to read all raster images in 36 formats! We have 
offered this guarantee for nearly 3 years. This guarantee means 
you and your customers get the highest quality imaging technology 
available. 

Incredibly easy to use interface that simplifies development! A 
single function call provides support for all 36 formats with 
autodetect. Simply pass the filename to our library! And if you 
want complete control, we give you that also. 

Al standard image compression techniques are supported 
including Group III, Group IV, JPEG, LZW, Huffman, Packbits, and 
Runlength. You can even create your own file format with Version 
5 using the built-in compression. 

Functions provided include rotate, invert, zoom, pan, scroll, resize, 
crop, sharpen, contrast, brightness, color reduction, gamma control, 
palette control, multi-page display, matrix convolutions, 
thumbnails, and much more. 

Performance is of the utmost importance to our customers and we 
continually push the envelope to achieve faster image loading, 
display, processing and compression. Version 5 is the best 
performer yet! 

We are now the acknowledged leader in imaging toolkits, and 
Version 5 is the next step in the evolution of high performance 
imaging! Call now to order or to get more information about our 
complete line of imaging toolkits. 





PICT 


SUN 




New 5.0 features: 

$ Faster image loading & processing 
$ All new, advanced color reduction 
£) New levels of flexibility 
^ Create your own format 
New compression algorithms 
5 Display while decompressing 
5 Status/cancel for all functions 
5 24 new raster formats supported 
Automatic thumbnails of any size 

5 New scanning features 

^ I/O replacement for total control 

6 Plus many more new features 

24 

New Formats'. 


Now Supporting 

Photo CD 


Pro Gold versions 


AII the features of standard toolkits PIUS: 


Fastest imaging toolkit available 
Lightning fast Group IV support 
Fastest JPEG available at any price 
Superb quality scale-to-gray display 
One hundredth of degree rotation 
Cornerstone ImageAccel supported 
Read any image sub-region 
Multi-page, high speed scanning 


WIN 


i 

f" \. 

[DOS 1 


I 




All Platforms Supported! 





Clipper 




DOS32 




MAC 



Guaranteed to read all raster 
images in existence in the 
supported formats. If you can 
find a valid image we don’t 
read, send it to us and we will 
make it work. 


(800) 525-3577 

(508) 898-2770 
(508) 898-9662 FAX 


High Performance Imaging 


Copyright 1994 AccuSoft Corporation. All rights reserved. AccuSoft Corporation 112 Turnpike Rd. RO. Box 1261 Westborough, MA 01581 
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Give Your Bugs The Bird! 

Get The Combined Power of A Heap Checker, Spy Utility, Debug 
Kernel, API Debugger And GPF Tool, All In A Single Package. 


N eed the perfect bug finding 
tool? Nu-Mega has it! — in 
Windows, DOS, WindowsNT, WIN32S 
even Windows 95. It's called BOUNDS- 
CHECKER ,M . Many say it's the most ver¬ 
satile and powerful automatic bug find¬ 
ing tool money can buy. Our customers 
love it because it saves them huge 
amounts of time and does "clean-up" bet¬ 
ter than anything out there. 

Where Do Bugs Come from? 

Today's bugs are just as likely to come 
from improperly interfacing with the oper¬ 
ating system or third party components as 
with your programming language. That's 
why we've expanded BOUNDS- 
CHECKER into a single comprehensive 
tool that points it's long bug hunting fin¬ 
ger at the types of problems you are most 
likely to encounter. 

Stop Problems like: 

■ API Parameter Errors ■ Memory And 
Resource Leakage ■ Data And Heap 
Coiruption ■ API Compliance Errors ■ 
Processor Faults ■ C/C++ Pointer Errors 
■ API Return Value Errors ■ VBX Interface 
errors and more! 

Find Out Why They Happen 

Your work is not always done when the 
bug is found. In fact, 50% of the job is 
finding out what caused the bug. There's 
great news though — BOUNDS-CHECKER 
works as your partner in helping you 
diagnose the problem. Along with giving 
you the description of the bug, 
BOUNDS-CHECKER reveals the source 
line that most likely caused the bug! For 
more difficult problems, you can access 
a variety of windows and inspectors that 
'show you the state-of-the-program at the 
instant the bug was found! And for "killer 
bugs", BOUNDS-CHECKER shows you 
the history of events that led up to the 
problem! What's more, with BOUNDS- 
CHECKER, you can go back in time and 
observe the series of Windows mes¬ 


sages, APIs and other events that preceded 
the bug. This is the power you've been 
waiting for — now turn week-long debug 
sessions into a few minutes work! 

New In BOUNDS-CHECKER! 

VBX and Windows 95 support— 
BOUNDS-CHECKER now validates the 
VBX custom control interface and logs VBX 



events as part of its trace history. Whether 
your program is written in VB, C/C++ or 
any other language, you can get a handle 
on some of the weirdest bugs you are like¬ 
ly to hit. 

TView™ - Cool Event Viewer! 

As your program runs, BOUNDS-CHECKER 
transparently logs messages, API calls, 
hooks, callbacks, VBX calls and many other 
events in a trace file. TView, BOUNDS- 
CHECKER's event viewer graphically orga¬ 
nizes and filters events so that you can see 
a high-level view of your program's run-time 
activity. When you want to see more 
detail, just click on events of interest to 


expand, level-by-level! You can also view 
API parameters and even bring up the 
source line associated with an event. 
Besides helping you see programs from 
the inside,(even on executables with no 
debug information), TView is an excellent 
tool for tracking down some of the tough¬ 
est Windows problems. 

The Perfect Q/A Tool 

If your job includes making sure your com¬ 
pany's programs are as solid as possible, 
you need the power of BOUNDS- 
CHECKER. Many of the bugs that 
BOUNDS-CHECKER finds will be invisi¬ 
ble during test cases, but this tool has 
eyes! You cannot possibly test every per¬ 
mutation on every conceivable system 
configuration —but, by using BOUNDS- 
CHECKER, you can flush-out the hidden 
bugs and greatly improve your quality. 

Don’t Doubt It, Do It! 

Next time, show your bugs who's 
boss. Give'em the bird! r- 


P--------- -j 

Order A Tno And Save A Bundle! 

Choose any two BOUNDS-CHECKER 
products and get the third FREE! 

BOUNDS-CHECKER 

□ For Windows □ For 32/NT 

□ For WIN32S □ For DOS 

□ Windows 95 Pre-Release Program 

(Call for ordering information) 


Special Trio Price: $498! SAVE $249! 
Call Nu-Mega Now! (603) 889-2386 
Or Fax This Form! (603) 889-1135 


□ VISA □ MasterCard □ American Express 

Card # ____Exp. __ 

Card Holder Name (Print)_ 

Signature_ 

Phone:_ 

^OverNight Delivery! Shipping/Handling Add $7.00 


BOUNDS-CHECKER, SOFT-ICE, AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies, Inc. All other trademarks are owned by their respective owners. 


CALL: 1-800-4-NU-MEGA (1-800-468-6342) 
Orders Only 

FAX: (603) 889-1135 

□ 

i? Nu-Me^ 

V TECHNOLOGIES INC 

RISK = NULL 

30 DAY 

MONEY BACK GUARANTEE 


Nashua, NH 03060-7780 U.S.A. 


Has Y &; 


SEE ADVERTISER'S INDEX FOR INQUIRY NUMBER. 


24 HOUR BBS 
603-595-0386 recycled paper 
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